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by Uric Gundrum 


Java Still Brewing 

There flits been more hype surrounding Sim's Java than 
anything else f rememlx.*r about the computer industry. 1 am not 
entirely sure why Java has generated so much excitement, f 
suspect it has something to do with the promise of truly portable 
computing; that is, write code once and run it anywhere and 
everywhere. Unfortunately Java is still very far from realizing that 
promise. In fact, it is about as dose to that promise as bad diner 
coffee is to a cup of home-brewed Sumatra. 

Don't get me wrong, I want a product to do what java 
promises just as much as everyone else. I would love to be able 
to sit down in a cafe with a public Java terminal. log into my 
web site, read mail, review my financial accounts, work on a 
few articles and write some code. Doing this from any computer, 
anywhere, and at any time would be wonderful. This capability 
would likely result in computers becoming more ubiquitous 
than telephones. However, Java is not up to it just yet. 

A Well Designed language 

In recent weeks, I have been doing some research into 
Java, This language seems well designed when compared to the 
likes of C++ and the other common object-based languages. 
The Java designers seem to be well versed the various object- 
oriented languages and pulled the best principles and 
techniques from many of litem. 

I particularly like the appropriate mix of keywords and 
punctuation. People cite C++ as an obfuscating language partly 
because it tends to use punctuation tor everything: just look at how 
many different meanings there are for a colon. C programmers 
complain alxnit Pascals use of keywords for everything. They get 
irritated by having to LyjK 1 “BEGIN* and “END* an infinite numlxT 
of times when simple braces will do just fine. 

java's syntax looks a lot like C++ on the surface, but it 
includes some of die verbosity of Pascal where the extra 
verbiage can he a real IxmefiL Java's designers did not go 
overboard; they use C-style braces to define scope, so you 
won’t gel tired lingers from typing “BEGIN* and “END* all over 
the place. However, they added “implements,* “extends," and 
other keywords to make the structure anti meaning of the code 
dear from the text, rather than relying on your memory and 
the terse symbols of C++. 

Another nice improvement is the absence of header files. 
Classes are declared in the same file in which they are 
implemented. The class declaration is included in the resulting 
binary object. Want to use a Java class in your applet? Just 
“import* the library file containing the c lass. The lack of header 
files, coupled with dynamic binding can eliminate many of the 
common problems coordinating the build process on multi- 
person projects. It also means fewer source files to maintain. 


One of tlie most touted Improvements is having memory' 
management built into the language. No longer do we have to 
waste so much time tracing down rogue handles or other 
memory errors. Unfortunately, the implementations of garbage 
collection in most Java environments still leave a lot to be 
desired, but this is just an implementation issue. Sooner or later 
die Java vendors will provide more efficient garbage collection 
to gain performance better than their competitors. 

Too Many Flavors 

The biggest problem with multi-platform Java 
development is that there are too many flavors of Java and 
they don't quite work the same. This means that we must test 
our applications on all of the available Java platforms if we 
want to lx! sure it works for the multi-platform audience. Java 
programmers have reported to me that they can spend as 
much as 80% of their development time trac ing and resolving 
pi at form-specific idiosyncrasies. Unfortunately, it looks like 
this problem will get much worse before it gets any better 
There are many more implementations on the way, including 
those embedded in microchips. 

What we need is an unambiguous specification for the 
language and libraries, and a certification prcx'ess to ensure each 
implementation abides by the spec. For the moment, Sun seems 
Uxj busy pumping the java media wave to deal with this issue. 
(Sun's “100% Java" campaign is an example of this hype. ) If this 
problem is not solved scx>n, it will likely be what stops the 
seeming endless momentum of Java. 

Conclusions 

Java is a nice evolutionary step beyond C++* but it is not 
the be-all and end-all of languages, Java incorporates features 
other languages have had for years, bringing these features 
into the mainstream, but the implementation is still immature. 
In time, Java should improve significantly, the programming 
community will become familiar with these “new" features and 
they will demand them of whatever succeeds Java. First, we 
have to get them working in Java. 

Apple has made a lot of noise about Java being important 
to their future success, and to ours. This makes sense. If Apple's 
hardware business dries up, anti their OS business dries up. 
what's left for them to do with their valuable brand name? 
Apple has been positioning themselves U> be an important 
player in the Java sandbox. 

Even so, Apple's Java strategy is way behind that of the rest 
of the world. Currently, Mac developers have to wait far Too long 
if they want to use the latest Java technologies on the Mac, Many 
developers don’t wait* they use another OS. Hopefully. Apple is 
fixing this problem; only time will tell. IE 
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A Cool Rhapsody Web Site & Navigating 
the OPENSTEP Doc 



Hopefully, by [he time you read this 
column, you’ve got a brand-spanking-new 
version of Rhapsody humming along on your 
Power Macintosh. My fingers are crossed! 
Either way, be sure to check out John 
Norstad's excellent Rhapsody web site ai 
<http;//dna rlotte.acns n wu. edu/jln Awwdc9 7. html >. 

The name of the site is the "1997 Apple 
Worldwide Developers Conference 
(WWDC) NUMUG Trip Report, A Rhapsodic 
Adventure”, Don't let the name fool you. 
'fhis site is much more than a WWDC 
rehash. First, it does an excellent job of 
reviewing the conference from a technical 
perspective, but it goes further than that. It 
presents a Lruly understandable picture of 
Rhapsody from soup to nuts. 

The site starts off with a brief 
introduction, then launches into a 
discusssion of Apple s dual OS strategy 
(Mac OS lives!) and delivery schedules. 
This is followed by John’s “gixxi news, bad 
news, good news" perspective on Apple’s 
problems. Next is a derailed Rhapsody 
Architecture Overview, complete with 
architecture diagrams to help you keep 
things straight and a discussion of Apple’s 
cross platform strategy. 

John graciously allowed me to include 
some of the material from his site in this 
column. Obviously, by the time you read 
this, the story will have changed somewhat. 
I encourage you to visit John’s site and get 
Lhe latest and greatest And, if you see John 
at a conference (he goes to all of them), be 
sure to thank him for a job well done. 

John Norstad on the Buie Box 

As you know by now, Apple's new 
Macintosh architecture includes a Blue 
Box, which represents the classic Mac OS 


rehosted on the Rhapsody core OS, and a Yellow Box, which 
represents die new, OPENSTEP based technology, also hasted on 
the Rhapsody core OS. Here’s some of what John had to say 
about the Blue Box: 

"Blue provides much better compatibility' than Copland. For 
example, almost all extensions work fine in Blue* Copland would 
have broken all extensions. 

Playing with Blue in the lab was actually quite boring, since 
it was almost indistinguishable from a plain Mac running Tempo. 
That’s the whole point, but it was still boring! 

In terms of compatibility for old Mac OS software, the 
transition from Mac OS to Rhapsody should lx* very' similar to the 
very successful transition from 68K to PowerPC several years 
ago, Most software will “just work”. There will be a few' problems 
and exceptions, but they should be minor. 

Hie only old software that will break under Blue are programs 
which talk directly to hardware without going through the Device 
Manager, .some kinds of extensions which patch File Manager traps 
and expea to lx* able to intercept all hie system I/O {Yellow Box 
file I/O to shared disk volumes will not lx" intercepted by these 
kinds of Blue Box parches), and any other software that modifies 
or relies on the internals of shared system services. 

Blue is not an emulator of any kind, It is mostly an exact 
copy of today's Mac OS, bug-for-bug, feamre-for-feature, just 
refloated on the new core OS, Most programs should run just as 
fast as they do on Mac OS, or perhaps only a little bit slower. 
Some operations will even run faster, clue to performance 
improvements in the core OS. 

Blue is very' similar to MAE (the “Macintosh Application 
Environment”), an Apple product which lets you run Mat 
software on unjx systems. Blue is simpler lhan MAE because it 
does not require a PowerPC emulator. Blue uses a RAM-based 
ROM image. There’s no hardware ROM, 

There is no preemptive multitasking or protected memory 
inside the Blue Box. A Blue application that crushes am still take 
down Lhe entire Blue Box, just like an errant application on Mac 
OS can take down the entire Mac. An errant Blue application, 
however, cannot crash the core OS or Yellow Box In Rhapsody, 
if a Blue crash occurs, you can easily and quickly reliant just the 
Blue Box, without having to restart the entire computer. 
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Behind every good Mac app... 
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...is a great 
text editor. 
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Source code from SMflt Deluxe displayed in BBEdit 




Aladdin System's Stuffit Dduxe, created using BBEdit 
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To the Mac OS running inside Blue, it appears as if virtual 
memory is turned off on a Mac with 1 gigabyte of memory! The 
core OS does virtual memory operations behind the scenes, but 
this is mostly transparent to the Blue Box, There are two 
important benefits of this new scheme: 

* No more worries about memory fragmentation! 

* You can set memory partition sizes very large with no 
ill-effects for most applications. 

The Blue Box will also provide improved stability via w guard 
pages’. Tlte.se are special virtual memory pages that are marked 
read-only and are placed at the beginning and end of each 
program's stack and heap. In the regular Mac OS, programs 
sometimes “run off the end” of their slac k or heap when writing 
memory, and end up trashing memory belonging to the system 
or other programs. This often causes bad crashes. In Blue, such 
a misbehaving program will crash, bur it won't take down other 
programs or the whole Blue Box along wiili it. 

Several people asked about tile following obvious idea: How 
al>oui having multiple Blue Boxes? This would give some of the 
benefits of preemptive multitasking and protected memory to Mac 
OS programs. Apple’s answer is that there are problems that 
would have to be solved. For example, each copy of the Blue Box 
expects to have exclusive write access to desktop database files. 
Also, the memory footprint would be rather outrageous. While it 
might be possible to do this in the future, it is unlikely that this 
feature will be included in Rhapsody's Unified Release. 

In summary, the Blue Box provides excellent compatibility 
for Mac OS software, comparable performance to the regular 
Mac OS, even better performance in some cases, and 
somewhat better stability. 

John Norstad on the Yellow Box 

Here's a snippet from John’s discussion of the Yellow Box. 

Ln addition to iLs OPKNSTEF foundation, the Yellow Box 
includes the following advanced technologies from NeXT, 

■ Multi-user system with security. Rhapsody can be used as a 
single-user system much like today's Mac OS T or you cm have 
multiple i 'Nix usernames and passwords with UNIX file security. 
Yes Virginia, you'll lx i able to telnet to your Rhapsody box! 

* PDO = Portable Distributed Objects. A state-of-the-art system 
for distributed computing. Objects running in separate 
processes on separate computers can send each other 
messages almost as effortlessly as they do when they are in 
the same program. One of the NeXT engineers who designed 
and implemented PDO presented at the conference sessions. 
I’m quite impressed by PDO. 

* FOP " Enterprise Object Framework* EOF provides an object 
interface to all of the major commercial database products. 
It’s important in the enterprise market. 

* WebObjects. This is a system for rapid development of web 
pages, CGI gateways, and web server plug-ins. 


The Yellow Box will also incorporate several major 
technologies from Apple: 

* The QuickTime media layer (QTMU: QuickTime, QuickDraw 
3D, and QuickTime VR. 

* QuickDraw' GX typography. 

* ColorSync 

* Scripting. At WWDC, Apple hadn’t decided exactly what the 
scripting language would look like (AppleScript or 
otherwise), but they promised Apple events and a ubiquitous 
scripting system integrated into the OPENSTKP classes. After 
WWDC, the trade press reported that Apple decided to 
support AppleScript in the Yellow Box. 

■ V-TWIN search engine* 

Applications running in the Yellow Box enjoy the full 
benefits of all the services provided by the Mach kernel, including 
preemptive multitasking and protected memory. Well talk about 
this more later when we go into more detail about ihe core OS. 

Go Visit the Site! 

The previous two sections represent the tip of the iceberg as 
far as this site goes. There are sections on Yellow and Blue 
integration, Rhapsody advanced kxjk and feel, technical issues to lx: 
resolved and, of course, the site will lx- updated by the time this 
issue hits the street. Spend the time to go through the entire site. 
Again, that URL is <hUp://charlotte,acns.nwu.edu/|1n/wwdc97,htnil>* 

The OPEN5TEP Librarian 

One of tile most important features of OPENSTEP that will likely 
make its way into Rhapsody is OPENSTKP's documentation system, 
known as the librarian (old time NeXT programmers know the 
librarian as the “Digital librarian* — Librarian is Lite current term). 

On the dock, look for an icon that looks like a series of six 
books, one next to the other (Figure 1). If you don’t have the 
l ibrarian in your dtxk, you’ll find the application in the 
directory /NextApps/Librarian.app. 



Figure /. 7 he Librarian icon . The librarian 
application is found in /NexlApps/lihrarian . afp, 

* Launch the Librarian application. 

The window that appears (Figure 2) is known its a 
bookshelf, A txxjk&helf is a collection of indexable, searchable 
documents. A series of examples will make this clear. 
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Figure 2. The bookshelf window that appears 
when the librarian is opened. 

* tn the Librarian application, select Open.,, from the 
Bookshelf menu, 

• Navigate all the way up and into the directory 
/NextLibrary/Btx >k$helves* 

The /NextUbrary directory is the default place for storing 
system resources suc h as application preferences. Since unix is a 
multi-user OS, there’s also a way to store preference-type files on 
a per user basis, in the user's home directory in a subdirectory 
called Library. For example, the global bookshelves are in 
/NextLIbrary/Bookshelves/, your own bookshelf is in 
/me/Library/Bookshelves/. 

By default, you'll find 4 bookshelf files in the 
/NextLibrary/lkxjkshelves directory (see Figure 3): DevToois,bshlf* 
EnlrepnseGbjectsdttihlf NextDevdoperJ>shli\ and SysAdmin.bshlf 



Figure 1 The four bookshelves in the 
/Next Lihrary/Books helves/ d i recto ry. 

• In Librarian's Open dialog, select DevTooIs.bshlf and dick 
the Open button. 

The DevToois bookshelf window will appear (Figure 4), 
In the top half of the window, you'll see 7 icons. Each icon 
represents a directory somewhere on your hard drive. The 
documents in that directory combine to make up a book. The 
Librarian can be used to search a book or set of books, based 
on a variety of criteria. If a lx ink's directory contains any sub¬ 
directories, the docs and directories in those sub-directories are 
part of the tree that makes up the book. 


To rephrase this, a bookshelf is made up of a series of 
books. Each book represents a tree of documents contained 
within a specified directory. 



Figure 4 The DevToois bookshelf window. 

Librarian allows you to build an index for a book. The 
index makes searching the book significantly faster than a 
search of the lx>ok without an index. You can tell if a book has 
an index by looking at the books icon in the bookshelf window. 
If the icon has a yellow dot with an upper-case T in the upper- 
left comer, the hook is indexed, A solid yellow dot indicates that 
while the book itself is not indexed, it is pan of a Ixxik that IS 
indexed, In other words, the book's directory is somewhere in 
the tree of an indexed book. Books within books. Cool! 

If a lxx)k’s icon has no yellow dot at all, the bonk is not pre¬ 
indexed, and searches are done in a much slower, grep-like 
fashion, Basically, if you plan on searching ;i book on a regular 
basis, make sure the Ixxik (or its ancestry) is indexed, 

* In the DevToois fxx)kshelf window* double-click Lite Tools 
Reference icon. 

The Target inspector window appears (Figure 5>- The 
Target Inspector allows you to modify the attributes of the 
selected lxx>k, Notice that the name of the book, Tools 
Reference, appears in bold next to the book's icon towards the 
lop of the Inspector window*. Underneath the icon and book 
name is a path, showing you hmv to get to the books directory. 
Note that this is a partial path name. In this case, the full path 
was /NextLibrary/Documentation/NextDt-v/Reference/DevTools, 
Note that the name of die book isn't necessarily the same as the 
name of its directory. 


Visit MacTech Magazine’s Web site! 

http://www.mactech.com 
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CONSIDER the possibilities. They’re 
wide open. Simply put, OpenPaige 1 ' can 
do anything you want to the text of your 
software application. 

Across platforms, across architectures, 
even UNIX \ OpenPaige is a feature-rich 
text environment. Every aspect of text and 
layout formatting, editing and display is 
possible. Stylized text. Scaling. Container 
and non-rectangular shapes. Style sheet 
support. Cut, copy and paste. Embedded 
pictures, objects, buttons and even calls to 
other applications are at your fingertips. 

Don’t waste time struggling with your 
text. We’ve already done the work for you. 
Drop in OpenPaige and go. Use as much or 


as little of it as you wish. Available as 
object code or as source code, it has 
an elegantly small footprint. Yet it will 
empower you to open doors, boundaries, 
and minds with your software application. 

But don’t take our word for it. Check 
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They've all discovered how the robust and 
flexible power of OpenPaige can open up 
entire new worlds of possibilities. 
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Figure y. The Target Inspector window, 
showing the index information . 

* Select Indexing from the Target Inspector’s popup menu. 

An Index pane will appear in the center of the window and 
a Periodic l ipdate pane will appear in the bottom of the window. 
There are three burtons in the index panel: Set Up, Delete, and 
Update. Use these to create a new index, to delete an existing 
index, and to update an index, making sure it reflects the current 
content's of the book’s directory. Note that updating an index is 
much faster than deleting and recreating an index. 

You can’t create an index for a directory that is pail of another 
index. Then again, why would you since an index already exists! 

'Hie Periodic Update checkbox lets you specify that the 
sysLem should update your index automatically, every X minutes 
or X hours. This is really nice if you’ve indexed a project's source 
code (good idea!) and want to update your source code index 
every night, for example! 

* Go back to the DevTools.bshlf window. 

* Double click the ReleaseNoles icon. 

This will bring up the inspector window. Note that the Set 
Up button is disabled (this Ixxik already has an index) and that 
the Delete button is enabled. 1)0 NOT delete this index. It is a 
useful one to have. If you do have the time and the inclination, 
go ahead and delete the index and then click the Set Up button 
to recreate it, litis will give you a sense of how long this can take. 

Note that you can shift-click to select multiple icons in a lx>okshelf 
window. Index commands apply to all the selected books. 

« Back in the DevTnols bookshelf window, shift-click to select 
all 7 book icons, 

* Click the last l ilies button. 


Underneath the text field, Librarian will tell you how many 
titles k found. In my case, the Librarian found 199 documents 
inside all 7 directories, 

* Type: the word "action 11 in die text field, then click the Search 
button or hit enter/return. 

You'll find around documents, each of which contains the 
word action. Very fast search, eh? The two popups underneath 
the text field allow you to constrain your search. You can search 
"In Contents” or "In File Name". The second popup lets you 
search using Word, Prefix, Within, Literal, and Expression. For 
the moment. Word is fast, the others are a bit slower. 

* Close the bookshelf window. 

Creating a New Bookshelf 

* In Librarian, select New from the Bookshelf menu. 

A new empty bookshelf window will appear. 

* Go to the Workspace application, into a File Viewer window, 
and navigate to the directory /NextLibrary/Fnimeworks. 

the AppKit and Foundation frameworks have associated 
documentation which is already indexed. We’re going to add 
these indexes to this new bookshelf. 

* In your File Viewer, continue descending into AppKit 
frame work/Resou rces/Cnglish.lproj/D< x;umenta t i on/Concepts. 

* Back in Librarian, drag the new bookshelf window so you 
can see it and die File Viewer at the same time. 

* In the File Viewer, drag die Concepts icon from the shelf into 
the top portion of the new bookshelf window. 

* Repeat this for the Reference and KeleaseNotes directories. 

Cogratulations — you’ve just created a bookshelf containing 
three Ixxiks. Note that all three directories are already indexed. 

Why create a bookshelf? Remember, each Ixiok is basically 
an indexable, searchable representation of all the documents in 
a specific directory. You can build a btxjk based on a directory 
filled with 100 source code files. Want to search the source code 
in that directory? Use the Librarian s Search button to search the 
Ixjok's index at blaztngly fast speeds. As you make your way 
through the rest of the column, you 11 see what l mean. But 
there's no substitute for actually Hying this out for yourself, 

* In Librarian, select Save from the Bookshelf menu. 

Though you can save the bookshelf wherever you like, 
stick to the standard and save it in your home directory in the 
Library/Bookshelves subdirectory, 1 saved mine in the 
directory /me/Library/Bookshelves/. When you enter a name 
for the new bookshelf, if you leave off the .bshlf, Librarian 
will tack it on for you. 


12 


Getting Started 


MacTech • September 1997 


















In the uNtx universe (and NEXTSTEP is based on trnix), a 
single machine can support multiple users, each of whom 
has their own account. Each user also has their own home 
directory. On my machine, my home directory i.s /me. If 
your home directory was /usr/puckett, you'd likely store 
your bookshelves in /usr/puckett/Lihrary/Bookshelves. 

Suppose we wanted to search the AppKit bookshelf we just 
created to learn how to create a new application, 

■ In the AppKit bookshelf window, select all three icons. 

• Type the word application in the text field. 

• Click the Search button. (I found around 2(X) matches.) 

• Select In File Names from the leh popup and do the Search again. 

By selecting In File Names (as opposed to In Content), 
weVe limited the search to documents with the word application 
in the title. Sometimes In Content wall prove to be a belter search 
and other times In File Names will work better. 

In this case, searching In File Names produced only 2 matches. 
Much betted Don’t worry if your numbers arc different than mine. 
After all, we arc likely ninning different versions of OPEN5TEP on 
different machines with different configurations. The is, if your 
search returns uxi many hits, try axil mining the search in some way. 

• We’ve just created and searched an AppKit Ixjokshelf Repeat 
the above procedure to create a FoundationKif bookshelf in 
the same directory. 

In broad terms, the AppKit is all the interface related classes 
and the FoundationKif is non-interface related classes, such as File 
handling, Exception handling, NS Object, etc. To really see the 
difference, build the FoundationKit lxx>kshelf and do a List Tides. 
Double-click on any title you like and it will open in Librarian. 

• To add man pages to a bookshelf, go to 
myhosi/Next I .i h rary/D( >cu menta t ion/ManPages/. 

• Drag icon off shelf into bookshelf window. Voila. Searchable 
man pages. 

Note the nr icon to the left of the document name, iliat means the 
doc is an nroff File. If the icon has a c it ls a .e file. There arc icons for 
rtf, folders, and lots of others. Just ns it would on your Mac, when you 
double-click a title or icon, the appropriate application wall he 
launched (or brought to the front) and the document will be opened. 
If you double-dick a directory, the Workspace will pop lo the front 
and a new' File Viewer will open for tiiat directory. 

Indexing Your Source Code 

• Back in Librarian, create a new bookshelf. 

• In a File Viewer, find /NextDeveloper/Examples, 

• Drag the Examples icon to the bookshelf window. 

• In the File Viewer, find 
/NextDeveloper/Examples/AppKit/TextEdil. 

• Drag its icon to the bookshelf. Drag any others you like. 


Note that TextEdit has solid yellow circle w^hile Examples has 
a Shift-1 circle. Examples is the directory with the index and 
the ancestor directory to TextEdit. TextEdit searches use the 
Examples index. Even so, TextEdit searches will only find files 
in the TextEdit area. The search won’t be quite as fast as if it 
had its own index, but the search will still be pretty fasti 

• Save your new bookshelf. 

So now we’ve got a bookshelf with a bunch of interesting 
sample source code. Suppose you wanted to find out how to 
save a document. You know that this source code does that. 

• Select the TextEdit icon, type* SaveDocument (one word) in 
the text field, then click Search. 

The search returns three documents. The routine we want is 
in Dcxaiment.HU 

* Double-click AppKit/TextFd i t/ Doeumcn un. 

Librarian will open the file for you. You can dick the Find 
button several times to find the SaveDocument routine. If you 
scroll down a bit to an else clause, you 11 find the term textStorage, 
To search on this term, select it, copy it, then paste it into your 
Ixxxkshdf text area and click the Search button. This is not as nice 
as Project Builder or Code Warrior’s find facility, but it is a very nice 
way to explore, to get your head around a new concept. 

The Easy way to Create a new Bookshelf 

* In a File Viewer window, navigate into 
/NcxtDeveloper/ExampIes/AppKit and selec t the AppKit icon. 

• Select Target from die Services/Librarian submenu. 

Librarian comes forward and creates a new bookshelf 
window containing the AppKit directory. That's it! You are 
now ready to search. 

* Launch the Edit application, 

• Create a new window, type the word LcxLstorage, and select it. 

* Select Search from the Services/LiI>rarian submenu. 

Librarian comes forward, and the fronLmast bookshelf is 
searched for texLslorage using the selected indexes. How axil is 
that? Notice that the librarian submenu also features Update Index, 
which lets you update the index of the directory containing the file 
you are editing (which is really nice if you arc editing source code! ) 

The Next Month**. 

This is the easy way to use bookshelves. More importantly, 
you've just had your first taste of OPENSTEFs services facility. In 
this case, die Librarian offered a series of services such as target 
and search, and Update Index, We ll get into Services in detail in 
a future column. But for now, why not use the Librarian to do a 
little research on Services yourself! HO 
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by David Rand 



Contour Plotting in Java 


Developing a simple , useful 
applet using Metrowerks 
CodeWarrior Java 


indicates the existence of an extremum — a peak or a depression 
— somewhere inside the loop. If the extremum Is pronounced, Le. 
a sharp peak or a deep depression, then several such loops will he 
nested together concentrically. 


Introduction 

This article discusses a Java applet 
which plots contours leased on a given 
matrix of floating-point values. The idea is to 
present an algorithm which is simple enough 
to he implemented in a few hundred lines of 
code yet which performs a useful, nan-trivial 
operation. Java is of course multi-platform, 
but this article focuses on development of 
the applet on the Macintosh, using 
Metrowerks CodeWarrior Java (specifically, 
CW11, which includes version 1.0,2 of the 
JDK), li is assumed dial the reader is at least 
somewhat familiar with the Java language 
and die GxlcWamnr environment. See, for 
example, Pave Marks series of “Getting 
Started” articles [1] in MacTcch magazine, 

A contour plot is a convenient way of 
representing three-dimensional data on a 
two-dimensional surface such as a map or 
a computer screen. If you have ever gone 
hiking and took with you a topographical 
map indicating the lay of the land, you 
have used a contour plot. The lines of 
constant elevation are the contours. If ihe 
lines are dose together then we have a 
region of steep slope, whereas widely 
spaced lines indicate more gradual slope. A 
closed contour looping back on itself 


Tu£ Plotting Algorithm 

The algorithm used for contour plotting is taken from a 1978 
article by W, V, Snyder [2j. The Java implementation was created 
by first translating Snyder’s Fortran source code manually into C, 
then reworking the C code to remove the many convoluted goto 
constructs, and finally manually translating tills “unravelled” C 
code into Java. The second step, necessary because Java does not 
support goto statements, proved to be the most laborious. This 
Incompatibility should not be considered a limitation of Java; on 
rite contrary, it is a result of the lack of appropriate block 
structures in old versions of Fortran. 

The plotting algorithm can l>e summarized thus: 

a) Given a matrix of floating point values which are the values 
of a function z = f{x,y) given at Lhe nodes of a grid of x and y 
values (the grid values are assumed equally spaced, although 
the horizontal and vertical spacing may differ), the program 
determines the minimum and maximum values of z and then 
computes a number of contour values (in this 
implementation, 10 values) by linear or logarithmic 
interpolation between the extrema. 

b) The program “walks" about the grid of points looking for any 
segment (ix\ a line joining two adjacent nodes in the grid) 
which must l>e crossed by one of the contours because some 
contour value lies between Lhe values of z at the nodes, 

c) Having found such a segment, it finds the intersection point 
of the contour and the segment by linear interpolation 
between the nodes. It also stores rhe information that the 
current contour value has been located on the cuirent 
segment, so that this operation will not l>c repeated. 


David Rand works at the Centre de recherches mathematlques (CRM) at the University de Montreal where lie manages the 
CRM's web site. He has developed a number of Macintosh applications such as die concordance-editor Concorde?3 and the 
shareware text- and list-editor Zephyr JJ. 
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<D The program then attempts to locate a neighbouring segment 
having a similar properly — that is, crossed by the same 
contour If it finds one, it determines the intersection point as 
in step c) and then draws a straight line segment joining the 
previous intersection point with the current one. This step is 
repeated until no such neighbour can l>e found, taking care 
to exclude any segment which has already fxxrn dealt with, 
e) Steps b), c) and d) are repeated until no segment can lie 
found whose intersection with any contour value has not 
already been processed. 

For a more detailed description of steps b) through e) of the 
algorithm, consult Snyder's article. Note dial, as staled in step d), 
the path of each contour is constructed of linear segments, the 
simplest method possible. A more sophisticated algorithm, based 
on bicubic Hermite polynomials, may be found in BL 

S he CodeWakkior Project 

The java applet discussed in Litis article was developed using 
Metrowerks Code Warrior Java on a Power Macintosh. Figure 1 
shows the window corresponding to the project file named 
ContourPlotApplet.j. Figure 2 illustrates the project settings. 
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Figure 2 ibe Project Settings. 


The project includes an html file, four java files (one for each 
new class) and the file classes. /ip. The settings indicate dial the 
project will generate an applet which will lie run using the 
Metrowerks java interpreter, and die classes (the applet as well as the 
three c lasses which ii uses) will have their object code .stored in class 
files in a folder called Classes inside die same folder its the project 
file. When die project is nm, ihe interpreter will look In the html file 
for an <APPLET> tag from which it will read (lie dimensions and 
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parameters of the applet. The html file can also be opened by a Java- 
enabled web browser to run the applet from within the browser; this 
wHi display the entire contents of the html file which may include 
instructions for using the applet or any related documentation. 



Figure 3 The ContourPhtApplet running in the 
Metrowerks Java interpreter. 



Figure 4, The ContourPhtApplet running in 
Netscape Navigator 3-0 Cold on a Macintosh . 


Figure 3 shows the applet running in the Metrowerks Java 
interpreter. Figure 4 shows the same applet (although using 
different data) running as part of a page at the web site of the 
CRM, University de Montreal; the web server is a Unix platform 
and the w r eb client, as shown in the figure, is Netscape Navigator 
running on a Power Macintosh. To serve the applet in this way, 
all dial Ls required in the UNIX file system is to create a directory 
called Classes in the same directory as that containing the html 
file and then to ftp (as raw data) Lhe four class files from the 
Classes directory on the Macintosh where they were developed 
to the Classes directory on the unix machine. 



Figure 5. The ContourPhtApplet running in 
Netscape Navigator 3-01 on a unix platform. 


As an illustration of platform independence, Figure 5 also 
shows the applet running in Netscape Navigator on a tjmx 
platform. The data here are the same as in Figure 3 except that 
logarithmic interpolation has been chosen. In addition, the eagle- 
eyed reader will notice that the character strings — such as the 
prompt in the upper left corner of the applet, the button, etc. — 
are in French. This is easily accomplished without modifying the 
applet, simply by changing the parameters in the <APPLET> tag 
Ln the html file. This requires, of course, that any language- 
dependent elements not be hard-coded in the Java source code. 
This approach is familiar to Macintosh programmers, who know 
that strings and such should be stored in an application's 
resource fork and not hard-axled in the application. 

As shown in Figures 3 t 4 and 5, there are six user-interface 
elements in [fie applet, each implemented as a java object of 
some type derived from the Component class. The contour plot is 
the largest component and is located in the right-hand part of the 
applet's rectangle. The other five components, ail located in the 
left-hand part, are 

1. The prompt "Matrix of z values:”. 

2. The daLa area in which the user enters the matrix of z values. 
Each row of the matrix is a list of floating-point values 
separated by commas and enclosed in brace brackets. Such 
as (0.5,1.1,1,5). T he rows also are separated by commas and 
the list of rows is enclosed in brace brackets. This format is 
similar to Madiematica syntax, for example. The rows need 
not all be of the same length; the program will complete any 
short rows wiih the appropriate number of zeroes. 

3. The check Ikjx for choosing logarithmic instead of linear 
interpolation for the computation of the contour values. 
Logarithmic interpolation is possible only if all the z values 
are positive. In particular, logarithmic interpolation is 
unavailable if the rows of the matrix are not all of the same 
length, because short rows arc filled with zeroes* 
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4. The "Draw” button. When die user dicks this button, the 
program parses die matrix in component +2, draws the 
contour plot if the data Is valid, and finally shows some 
results Cor an error message) in component #5. 

5. The results area in which the applet displays some 
information about the plot just drawn. If die data are not valid 
for some reason, an error message will appear here. 
Otherwise, this area will display the number of rows and 
columns in the grid, the matrix of z values (with some rows 
extended by zeroes if necessary to make the matrix 
rectangular), and finally the ten contour values, numbered 
from 0 through 9, 


The Source Code 

The source code consists of an html file anti four java files, 
one for each newly defined class. Eac h file has die same name as 
the class whose source code it contains, with the extension java 
appended. Thus the file ContourPlotApplet.java contains die class 
ContourPlotApplet etc. Flanagan HI is an invaluable reference for 
information about Java classes predefined in die Java API version 
1.0, from which the classes discussed here are derived. 

ContourPlotApplet is the main class of the four and is derived 
from java.apptetApplel, The class ContourPlotLayout is used to 
layout the user-interface items in Lite applet's rectangle. 
ContourPlot contains the code, adapted from Snyder [21, whose 
Lask is to draw the applet's most important component, the 
contour plot itself. Finally, ParseMatrixException is used to signal 
error conditions corresponding to invalid data. 

ContourPlotAppleLhiml 

This html file contains the <APPLET> tag which declares the 
CODEBASE (that is, the folder where class files are located), the 
CODE (that is, the name of die applet class), the graphical 
dimensions of the applet and its parameters. This <APPLET> rag 
is shown in listing 1; for brevity, some of the parameters are 
omitted from die listing. 


Listing 1 

<APPLET CODEBASE^"./Clares/ K 


The <APPi.HT> tag in GmtourPloiAppio hrml 


CODE-XontonrP lot Applet, class" WIJ3Ttt=n5 HETGHT»460> 


<PARAH NAME*"st tin gX M 
<PARAM NAME-”string¥ w 
<PARAH NAME""AtrlngZ w 
CPARAM NAME-' f GtrlngBDX n 
<PARAM NAHE^eiringButton" 
CPARAM NAME*"stringResults* 
<!- Other parameters here -> 
</APPLET) 


VALUE^ w Nuabe r □£ rows:") 
VALUE-"Number of columnsi "> 
VALUE“"Matrix of z valuer:*> 
VALUE -1 "Log interpolation") 
VALUE"'" Draw") 

VALUE-"Contour values:"> 


ContourPlotApplel.java 

ContourPlotApplet is a container for all the user-interface 
elements. Its source code is shown in Listing 2, The class starts 
with a few final static variables (constants) the keyword final 
indicating that the variable's value may not l>c changed and the 
keyword static indicating that it is a class variable, noi an 
instance variable. These are followed by the six user-interface 
components shown in Figures 4 and 5, and finally a number 


MkLinu 

Microkernel Linux for the Power Macintosh 

Why wait for Rhapsody? MkLinux is a complete system, 
based on Linux 2 and the Mach 3 microkernel. It includes a 
complete software development system (gcc, gdb, perh ,..), 
X11R6.3, and hundreds of other commands. Get MkLinux 
and start working right now with Mach, Object! ve-C, UNIX 
development tools, and more,.. 

MkLinux builds and runs most Intel-based Linux software. 
It works efficiently and reliably on a wide range of Power 
Macintosh platforms, with other ports on the way. MkLinux 
has an active user community and a substantial Reference 
Release, both sponsored by Apple Computer. If you want to 
get a jump start on Rhapsody, this is a great way to do it! 

Visit Apple's MkLinux web site (www.mklinux.apple.com) 
and Prime Time Freeware's web site (www.ptf.com) to find 
out more about MkLinux and other fine freeware products. 

Prime Time Freeware inio@ptf.com 

370 Altaic Way, #150 (408) 433-9662 

Su nnyvale, CA 94086 (408) 433-0727 fax 


of static (class) variables which are String objects used to store 
strings read from the <APPLET> lag and subsequently to display 
messages in the results area. These data members are followed 
by the class' three methods initQ, handleEvent(Event e) and 
DrawTheConlourPlotf) which are explained in the comments in 
the source code. This last method is the most important and 
calls several key methods in die ContourPlot object, especially 
thePlot,paint(Graphics g). 


Listing 2 

Con taurPiocAp pki. java 

//“ComourpimAppkf is ihc main class, that is, the applet, 

// which is a container for all the user-interface elements, 

import java.awi.*; 
import java.io,"i 

public class ContourPlotApplet extends java .applet-Applet [ 

// Bekjw, constants, be.*final static" data members: 
final static int NUHBER^COHPONENTS « 6: 
final static int MIN ,X_STEPS = 2, 

MIN_Y_STEPS- 2* 

MAX_X_STEPS= 100, 

MAX_Y^$TEPS" 100; 
final static String EOL “ 

System.get Property(*1ine.sepa ra to r"): 
final static String DEFAULTS = 

"I (0,5,l.l.t-5,1*2.0.3.3,2,1,0,11+ EOL + 

M M.0*1.5*3.0*1*6.0*2.1*1.2*1*41," + EOL + 

" 10.9.2*0,2.1,3*6,0,7,1,2,1,1,41+ EOT* 4 
“ U,0*1,5.3.0.4,6.0*5,2,1.5*1.21." + EOL + 
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" 10.8,2,0.1.0.3.4.0.4,3,2.4.2,31," + EOL + 

“ (0.6,1,M.i. 1. 4,0.3.5.3,2, ML" + EOL + 

" 11.0,1,5.3.0.1.6.0,2,1.1-2.2.7.41," + KOL + 
* 10.8.1.0.3.0,11.5.5.6.3.2.1.J.41," + EOL + 

" 11.0.1.5.3.0.4.6,0.5.2 J .0.5,0.21 P: 


// Below, liit six user-interface component 
ContourPlot thePlot = 

new ContourPloL(M1N_X_STEPS, MIM_Y_STEPS}; 

Label ^Prompt = new Label (**“, Label, LEFT); 

Text Area aField = new TextArea (DEFAULTS. 30 1 6); 

Checkbox interBom “ new Checkbox (); 

Button drawBtn = new RutttmO: 

Text Area results = new TextArea(); 

// Ueluw, dais data members read from Uit <APPLFT> tag: 
static String,comaurVaiuesTitle*infoSt rX.infoStrY, 
etrPac se,e rrLog,errComp.er rEquai, 
errExpeCt.errEOF. errBaunda: 


//'inir overrides ’ super. initO* awl Initialises the applet by: 

// 1 getting parameters From the <APPLET> tag' 

// 2 , setting layout to instance ofTunmurPlotI,ayour; 

// 3. initializing and adding I lie six user-interface 
// components, using d ie metht hI " atidQ’ which will 

// also call XamiuurPlotlmyou t^ukiLayomComponciitO". 

public void initO [ 

infoStrX w get Parameter (“stringX”) : 
InfoStrY * getParameter("stringY") : 

set Layout (new ContourPlotlaayqut {)) ; 
add(“thePiot". thePlot); 

^Prompt * setText (get Pa r nine 1 1 ? r (“st ringZ ")); 

add(“zPrompt", /.Prompt); 

zFieid.netBackground(Color,white); 


add(“zField\ zFieid): 

interBGX.netLabel (get Parameter ("stringBox")): 
interBox.setStatc(false): 
add(“interBox”, interBox): 

drawBrn .seiLiibel (getParatneter ("stririgButiun")); 
drawRLn.setFont(new Font("Helvetica", Font,BOLD. 10)): 
drawhtn,setBackground(Color.white)j 
add("dravBtrr , drawBtn); 
results.setEditablcffalae): 

results * set Font {new Font(“Courier", Font. PLAIN. 9)); 
results.setBackground(Color.white); 
add(“results". results); 

ContourValuesTitle - getPararaeter ("stringResults") : 


errParse 
errLog 


err Comp 
errEqtml 
errExpect 
errEOF 
errBounds 


getParameter(“sLringErrParse”); 
getParametcr (“str^ngE^^Logl■ , } * EQL + 
getPara0ieter(“stringErrLog2”) + EOT. + 
getParameter ( “ st ringEr rLogl") : 
gel Parameter{“stringErrComp“1: 
getFarameter ("strlngErrFqual") ; 
getParameter ("st r higErrExpect"): 
getParameter (“sirifigErrEOF"); 
getParametcr{"stringErrBounds"); 


//-----—- 

// Handle events. The only event nut handled by the superclass 
// is a mouse hit (ic.‘EvcnLAtTK>N EVENT*) in the h l>raw* button. 

public boolean handleKvont(Event e} I 
if (U 1= null) 66 

(e + id — Event.ACT1QN_EVENT) && 

(e.target drawBtn)) t 
DrawThoContourPlot(): 
return true* 

I 

else return stiper.bandleEvent(e): 


Wa 



i 
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// “DrawlW^intourPkK - docs what its name says (in reaction to a Ini 00 the 
//"Draw 1 * button). Thr gut* of this method arc in the ‘try* block winch 
// l. gets the interpolation flag (for contour values); 

// 2, parses the daia, i.c, the matrix of t values; 

// 3. draws the contour plot by calling the "painter 
// method of the component “ ihePSot * ■ 

// 4. displays the rcsultsj.c. the number of rows and columns in the grid, 

// an echo of the matrix of z values* and the list of contour values. 

//This method catches 2 exceptions, then finally (Lt, regardless of exceptions) 
// sends a completion message to the Java console using s System out,printlnO', 

//---—-—----- 

public void DrawTheCoutuur Flot (} I 
String si 

try | 

s - zFlelcl .getText f}; 

theFloL.loginiorpol at ion = InterBox.getStflteO ; 
thel?lot ,FursoZedf!aLrix(a) t 
the Plot .paint (thoFlot .geiGraphlcsO ); 
s - thePlot:*ReturnZedHatrix{) + 
contourValuesTitie + EOL + 
thePlot,G@tContourValuesString{J; 
resulta*setText (s) ; 

1 

catch(PartJcMiurixExccplIon e) l 
thePlol,regain L(); 
results.setText (e,getHesi;ageO ); 

I 

catch(lOExeeption e) l 
thePlot.repaint(); 
results,setText(e,getHessage0); 

J 

finally l 

System,uut.printlnf"Exiting GrawTfteContourPlot*); 

\ 

) 

I 


CoiUourPlotLayout.java 

ContourPlotlayuut us derival directly from javalang,Object and 
implements the interface java awl, LayoutManager. Ils source code is 
shown in Listing 3. Recall that an “interface'’ in Java is an abstract 
class in which all methods are abstract, and is Java’s limited way of 
implementing mix-in classes, lhai is, allowing a very restricted degree 
of multiple inheritance. Since an interface is completely abstract, all 
its methods must be overridden in any class which implements il, 
and that is the case here: ContourPlotLayout coma ins implementations 
of all five methods — addLayoutComponent, layoutContainer, 
minimumLayoutSiza preferredlayoutSlze and removeLayou (Component 
— declared abstractly in java.awt.LayoulManager. 

The purpose of ContourPlotLayout is to lay out the six user- 
interface components inside our applet’s rectangle, Jhc Java APT 
includes several layout managers, such as FlowLayouL 
BorderLayout GridLayout, etc. (again, see Dave Mark's series of 
Getting Started articles in MacTech), but none was deemed 
appropriate here because it was desired to assign special fixed 
values to most (hut not all) of the positions and dimensions of 
the components* The six components are stored in an instance 
variable, an array k, whose values k[0] through k[5] correspond to 
the applet's instance variables thePlol, zprompl. zRekh InterBox. 
drawBtn and results, kfl] through k[4] are of fixed position and 
dimension. The other two components, that is, the contour plot 
and the results, also have fixed position, but may change in size 
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as the applet's dimensions change (for example, if the applet's 
window is resized in the Java interpreter)- The contour plot will 
be made as large as possible while remaining square, while its 
size never falls below a certain minimum, the constant (that is, 
static final) MtN_PLOT_DIMEN, The results area's width never 
changes, but its height expands to till the available space while 
never falling below the minimum MIN_RES. HEIGHT 


Listing 3_ 

CoatourPtotLayoutjava 

// ComourPtotLiymit implements the intcrfocc Layout Manager 
// & is used by ComonrPIoTApplet to lay out its components- 

impo rt j ava.avt.*: 
import java.io,*; 


public class GontourPlotLayout 
extend b java.tang,Object 
implement s Java*awl - LayoutManager f 


// Below, constant data members: 
private static final int COUNT - 

Cont ourPlotApp let. N UM BE R_COMPONRNT S: 
private static final int 


MARGIN 

MI N_ PLOTJDIMEN 

LEFT_WIDTIl 

CB0X_W1DTH 

BUTTON Jl_FOS 

BUTTON. WIDTH 

LINE HEIGHT 

DATA_HEtGHT 

MTN„RES_HEIGHT 

DATA„V_PG3 

BtFTTON_V r _POS 

RESULTS _V_F 0 S 


5* 

300, 

250. 

130. 

MARGIN + CBOX WIDTH + MARGIN, 
LEFT.WTDTH - CftOX_WIPTH MARGIN, 
25 , 


105. 

50 , 

MARGIN + MARGIN + LINE HEIGHT* 
DATA_V_P0S 4 MARGIN + DATAjtfcTGHT. 
BUTTON V PGS + MARGTN + LINE_HEIG1IT; 


// Below, data membe rs: the army of components, the dimensions of 
// the contour plot component and the height of (he results area. 

Component k[] - new Component[COUNTj; 

Dimension d = new Dimension( MIN PLOT DIMEN, 

M T N_PLOT_D T MEN): 

int results height = MIN RES HEIGHT; 


tl -:■---—-~~-— 

// “addLayoirtComponcnr is necessary \o override the 
// corresponding abstract method in ‘UyuuiManager’, 

public void addLayoutComponent(String name. Component c) 

f 

if (name.equals("thePlgt:*)) I 

c.reshapef 2*MARG1N+LEFTLW1DT11, MARGIN, 
d.width, d.height); 
addCompoceiitNimber(0*e) ; 

I 

else if (name, equals("zPrompt")) I 
C.reshape( MARGIN, MARGIN, 

LEFT_WIDTH« T.TNF._HEIGUT) ; 
addComponent Number (I, u) ; 

I 

else if (name.equals("zFieid")) I 
e*reshape( MARGIN* DATA_V_P03* 

LEFTJJIDTH. DATA HEIGHT); 
addComponentNiunher (2 t c) ; 

1 

else if (name*equals("interflox")) I 
c. reshape ( MARGIN. BUTTDNJLPOS, 

CBOX_WIDTII. LINE_HEIGHT) : 
adtlComponentNumber (3 ( c); 

J 

else if (name*equala(*dravBtn")) I 

c.reshape{ BUTT0N_H_P0S. BUTT0N_V_POS, 

BUTTON_WIQTH, LiNKJiEIGHT); 

addComponentNumber(4,c); 


else if (name.equals!'‘results")) f 
c.reshape! MARGIN, RESULTS.V_FGS. 

LEfT_WXDTH, result s_h eight); 

addComponentNumber{5 * c) : 

1 

// throw new SomeKiudOfExccption( 

// ’■Attempt to add an invalid component*); 


// -——-■--— 

// ■’GctDimciusions computes tlic data members “d“ and 'results_h right" 

// which arc the only dimensions in the layout which are not fixed. 

public void GelDimensions(Container parent) ( 
d = parent.size(); 

d.width - d.width - LEFTJJIDTH 3'MARGIN; 
d.height = d.height - 2 * MARGTN; 
if (d*width < MIN_PLOT.DIMEN) 
d,width - M1N_PLQT_DIMEN: 
if (d,height < MIN_FL0T_DIMEN) 
d.height = MIN_PL0T_DIMEN; 
if (d.width > d.height) d.width = d.height: 
else if (d.height > d. width) d .height - d.width; 
res tilts .height - d. height + MARGIN RESULTS JV_P0S; 

If (rcsults_heighl < MlNJiESJiKlGHT) 
reaultajieight - M1N_RES_HEIGHT; 


// ------- 

// "add(iomponentNumber* adds a component given its index 
//and is a utility routine used by*addljrymitCompontnt", 

public void addCompanentNuraber(int i, Component c) I 
if ((i < 0) || (i >“ COUNT)) I 

throw new ArrayXndex0ut0fBoundsExceptlon{); 

1 

else if (k[i] 1= null) ( 

if throw new SomeKindOfExeeption{ 

H “Attempt to add a continent already added"); 

I 

else kLiJ - c; 

J 

//■‘layoutContaincr’Is necessary to override the 
// corresponding abstract method in u Lay ollI Manager t 

public void layoutContainer(Container parent) I 
GetDimensions(parent); 
if (k f0j != null) k[0]* reshape 

(2*MARGTN+i,EFT WIDTH,MARGlN.il.width,d.height) ; 
if Ck[I] I- null) k[l].reshape 

[MARGIN.MARGIN.LEFTJJIDTH.LINE_HEIGHT) ; 
if (k[2] t= null) k12J.reshape 

(MARGIN.DATA_V_PGS,LEFT. WIDTH,DATA HEIGHT); 
if (k[31 t-mill) k [3] .reshape 

(MARGIN .BUTTON V _ F03 . CflOX_ WIDTH * LI NEJIE T GHT) : 

If £k[4l null) k[4]* reshape 
(BUTTONJ_P0S, HUTTON_V_P0S, 

BUTTON^WIDTH.L1NEJ1E1CHT) ; 
if <k[5j 1= null) kL3J .reshape 

(MARGIN t RESULT5_V_FGS,LEFT.WIDTH.r esult s ^height); 


//---—-— .. .— 

// mininuiml.ayoutSi/c’'is necessary to overritlc the 
//corresponding absinict mctluxJ in"LayoutManagerT 
//---—--—-—- 

public Dimension minimumLayoutSize(Container patent) I 
return new Dimension( 

3"MARGIN i LEFT.WIDTH + MIN_P7,0T_DTMEN, 

2"MARGIN + MIN PLOT ,15TMEN) ; 

) 

// “prelerreULayouiSi/c’’ is necessary to override the 
// corresponding abstract meduxi in 'Uvou[Manager". 

//-—--—--- 

public Dimension preferredT.aymitSize(Container parent) I 
GetU]mensions(parent); 

rolLLrri new Dimension! ^'MARGIN + d,width. + LEi'"T_WIDTH. 

2"MARGIN + d.height): 

1 
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// ‘remove!jyoutComponent“ is necessary to override the 
//corresponding abstract method in“laymnManager*. 


public void removeLayoutCompon eih(C omponent c) \ 

for (int i - 0: i < COUNT; i++> 
if (c — kfi]) k[i| - null t 

I 

1 

ContourFloLjava 

ContourPiot, part of whose source code is shown in Listing 
4, is derived from the class java.awt.Canvas. An instance of it is 
used by the applet as the user-interface component which parses 
the data, draws the contour plot, and returns a string of results. 
This class begins with a number of constants: noLe, for example, 
the characters OPEN_SUITE and CLGSE^SUITE specifying 
delimiters in the matrix to be parsed and BETWEEN_ARGS which 
specifies the data separator between values in the matrix; note 
also the platform-independent way of assigning a value to EOL, 
as recommended in [51. 

The data members xSteps and ySteps are used to hold the 
number of horizontal and vertical steps, respectively, in the grid. 

The matrix z will contain values of type float and is declared 
to have two indices but the number of components in each 
dimension is initially unspecified. The number of rows in z and 
the length of each row will he incremented as die data are read. 
The matrix will Ik? made rectangular only after all data are 
parsed; in fact, Java syntax allows one to use an array of arrays 
(such as z here) in which the ’Inner" arrays need not have the 
same length. For example, the length of die row of z is given 
by z[x].. length. Nodce that, according to standard java practice, the 
memory allocated for the matrix z is never disposed, even when 
new data are parsed, since garbage collection is performed 
automatically by die Java interpreter. Or to express this in 
different words, the contents of z may be "disposed" by simply 
performing the assignment z - null which has die effect that any 
previous contents of z are no longer referenced (unless they have 
been assigned to some other variable other than z) and may thus 
lx garbage-collected by the interpreter at its convenience. 

The data members d, detlaX r deltaY are measurements, in 
pixels, of die dimensions of the contour plot and the distance 
between grid lines horizontally and vertically. 

Most of the remaining data members arc variables adapted 
from Snyder's Fortran subroutine GCONTR. See [2] for a 
discussion of their meaning. 

The various methods in the class ContourPlot are explained 
briefly by comments in the full source code included with the 
project. The most important are paint(Graphics g) and 
ConlourPlotKernet(Graphics g, boolean workspace!]). The former is 
called directly by the applet and in turn calls the latter which 
corresponds to the “outer" level of the plotting algorithm adapted 
from Synderis subroutine GCONTR, (For brevity, some methods 
have licen omitted from Listing 4, in particular a few methods 
which are called directly or indirectly only by ContourPlotKernel 
and thus include only code adapted from Synder.) 


listing 4_ _____ 

Selections from ContourPlot java 

//‘ContourPlot* is the most important class. It is a user-interface component which 
// parses the data, draws the contour plot, and returns a string of results. 


import java.awt.*: 
import java.io.*: 

public class ContourPlot extends Canvas I 


// Below, constant data members: 

final static boolean £HOW_NUMRF.RS " true; 

final static int BLANK = 32. 

OPEN.SUm « (int) * I *, 
CL0SE_SUITE - 

BETWEEN ARGS - (int) V , 
N.CONTOURS " 10. 

PLG7_MARGTN - 20, 

WEE_B1T - 1. 

NUMEER_LENGTII = 3; 

final static double ZJ4AX_MAX * 1.0E+10, 

Z_HINJ1 IN * -Z_MAX_MAX; 
final static String EOL “ 

System.getProperty(“line.separator"); 


// Below, data members which store the grid steps, 

// the / values, die interpolation flag, the dimensions 
// of the contour plot and the increments in the grid: 

int xSteps. ySteps; 

float sflll; 

boolean logTnterpolation “ false: 

Dimension d; 

double deliaX, deltaY; 


// Below, data members, most of which arc adapted from 
// Fortran variables in Snyder s code: 

Int nev = N CONTOURS; 

Int 11 [1 = new int [4l; 

int 12[J * new int[4]: 

int ij[] = new Int [2] ; 

int ilLi - ne W int[2]; 

int 12[ | - new int [2] ; 

int 13[] ^ new Int [61: 

int ibkey.icur. jcur ,ii* j j , elle, ix. iedp .iriiig.n i .kn; 

int cntrTndex.prevIndex; 

int idle.nxidir.k: 

double %1 ,z2 , eval,zMax,7.Kf n; 

double intersect[1 - new doubte[4] ; 

double xy[] “ new doublets] ; 

double prevXYU - new double [2] ; 

float cv\] * new float [nev]; 

boolean jump; 


// ----- 

//A constructor method. 

public ContourPlot(int x. int y) { 
super()* 
xSteps = x; 
ySteps ^ y; 

setForeground(Color.block); 
setBackgroUnd (Color .wtii le): 

j 


//ITic following routines are omitted from this listing. 

// Sec the hill source aide included with the project 
// 

// int signfint a, inf b) 

// vuid lnvalidl)aia() 

// void (ictExtttmesO 
U void SctMeasurtmeiitsO 
// void PetectRoundaryO 
// boolean tioutinejabd. 0200 
// Ixxikan Rou»meJabdJ)50Q 
// bookman RoutineJabd_ 1500 
// slK>rt RotUine_labd_200( Graphics g, 

// boolean workspace 11) 

// void QmtinucContourO 
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// ^ssignr/mtoirrValiJCs' interpolates between *seM in' and “/Max', either 
// logarithmically or linearly, in order |o assign cuntour values to the array "tv*. 

void AssignContourValuesQ throws ParseNaf r'f xExccpt ion \ 
int i; 
double delta; 

If ((1 nglTiierpolutiun) kb (zHln 0.0) J I 
TnvalidDotaOi 
throw new 

ParseHatrixException(ContourPlotApplet,erring): 

if (loglnterpolation] l 

double temp ■ Math.logEzMin)r 

delta * (Multi.log(zMax) temp) / nev; 
for (i - 0; i ( nev; i++) 

eviij = (float)Hath.exp(temp 1 (i>l)*delta); 

I 

else I 

delta ” (zMax /Min) / nev; 
for ft - 0; 1 < Ttcvi i++) 

cv[l] * (float) (zHin + (i+1.) ’-delta] : 

I 

) 

//' C iti< miourValuesString’ returns a list of the 
// contour values for display in the results area 

Siring GetContourValuesString() t 
Strings = new StringO ; 
int i? 

for (i = 0; i ( nev; 14+) 

s * s + rt [* + Integer,toString(i) 

+ "] " + float.toString(cvUJ) + EQL; 

return at 


//---- 

// 'Dtnwdrkr draws the rectangular grid of gray lines 
// on mp of which the contours will later be drawn, 

void DrawCrid(Graphics g) I 
int i.j*kx,ky; 

// Interchange horizontal & vertical 

g, r 1 o.i r Reel (0* 0, d . heights * FL0T_MARGtN„ 
d.width +2*PL0T_MARGIN); 
g.jietColor (Color, gray): 
for (1=0; i < xStepe; i++) I 
kx ■ (int)((float)i * deltaX); 
g,drawUne{PU5T KARGIN, 

PLOT_HARGTN+kx. 

FLOTJiARGl»+d.height, 

P Lt)T_M ARC i N+kx) : 

I 

for (j = 0; j < ySteps; j++) I 
ky * tint)((float)j * deltaY); 
g.dravline(PL0T MARGIN Iky, 

PLOT MARGIN. 

PT,OT_HARGIN+ky * 
PLOT_HAR(SlN+d. width); 

I 

g.tmColur (Color.black); 


it -------- 

//“ DrawKernel n is the guts of drawing and is called directly Or indirectly by 
// XoniourPiorKemd' in order lo draw a segment of a contour or to set the pen 
// position ‘prcvXY*. Its action depends un'ifljg" 

// 

// iflag — I means Continue a contour 

// ifLtg — 2 means Start a contour at a boundary 

// iflag = 3 means Start a contour not at a boundary 

// iflag = 4 means Finish contour ni a boundary 

// iflag = S means Finish dosed contour noi ai Exiundan 

// iflag == 6 means Set pen position 

ff 

ff If the constant "SHOW NI'EMBERS’ - is true, then the contour index is drawn 
ff adjacent to where the contour ends when completing a contour (iflag =. 4 or 5). 

void HrawKeruel(Graphlea g) E 
Int previhpievV t u* v; 

if ((iflag “= 1) || (iflag — 4) |j (iflag = ■>)) I. 
if (cntrlndex E= p rev Index) [ // Must change colour 
SetColour(g ): 
ptevlndex = cntrTndcx; 

1 

prevtl " (int) ((prevXf [0] 1,0) * deltaX); 

prevV - Unt)((prevXY[l] - 1.0) * deltaY): 
u = (int)(( xy[ 0J - 1,0) " deltaX); 
v = (int)((xy[11 - 1.0) * deltaY ); 

ff Interchange horizontal & vertical 

g.drawLJne{ PL0T_HARGIN+prevV,PL0T_MARGIK+prevU, 
PLOT_HARGiN+v. PLOTjtARCIN+u): 
if ((SliOW_N UMBERS) kb ((iflag—4) || (iflaf>=5)>) ( 
if (u *- 0) y - u - WEE.BIT; 

else if (u = d.width) u - u 4 FL0T_HARGIN/2: 

else if (v “ 0) v - v PL0T_MARGiN/2; 

else if (v ” d.height) v v + WEKJ8IT: 

g + drHwSt r1ng(IntfgcM ,toSltIng(cutrIndex), 
PL0T_ffARGiN+v, PL0T_MAKUlN+u): 

) 

I 

prevXYLOl = xylol; 
prevXY[l] = xy \ 1 ]i 


ft-— -—---■ ■ - - - -— 

// "CrossedByConiour* is true iff Lite current segment indie grid is crossed by 
//one of the contour values and h:is mx already been processed for that value. 

boolean GrossedRyGontOiir (boolean workspace []) f 
H = i j [0] + 11 Idle] : 
jj - i J [11 + ±1 [1 idle]; 

*1 = *[ij{0]-l]|ifllj I]; 
z2 ' zfiilj (Jj'l): 

ior (cntrlndex 0; cntrlndex < nev; cntrlndex^) t 
int i = 2*(xSteps*(ySteps*entrIndex+1J[I] 1 ] 
Hj(OM) + elle; 

if {!workspace[l]) ( 

floei x = cv[cntrlndexIi 

if ((x>Math.iiiin(zl. zl) ) hk (x<-Math.max(zl,z2))) 

I 

workSpaceli] = true; 
return true; 

I 

] 

1 

return false; 

I 


ft --- 

//"Self ailour" sets the colour or the graphics object, given the contour 
// index, hy interpellating lioearEy between "Color.blue" & Xolor,red" 


void SctColuur(Graphics 
Color c " new Color< 
((ncvcntrlndex) * 
cntrlndex * 
((ncv-cntrTndex) * 
cntrlndex * 
({nev ciurindex) # 
cntrlndex * 
g.setColor(c); 


*> i 

Color.blue.getRed() + 

Color .rod.geiftcd O) /nev. 
Color *blue.gotGreenl) 4 
Color * red,getC reen())/nev, 
Color.blue.getBlue{) + 
Color. red. getBlue 0 3/rtev); 


//"ContourPloiKemer is the guts of this class and 
ff corresponds to Synder s subroutine ‘GCONTR" 

void Con lour Plot Kernel (Graphics g. boolean workspace!]) 

I 

short val_label_200; 

11f0l — xSteps; 11 [ I] “ ySteps; 

11[2] “ -1; !113] " It 

n[0] - 1; il [1 ] = 0; 

12[0] * 1; 12[1] = 1; 

n[0] = 1: i3[lj * 0 : 13[ 2 j - 0 ; 

i313J - 1; 13141 - l: i3[51 - 0; 
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Purify on Unix 
Bounds Checker on Windows 
Now, from the makers of QC, comes... 



qht 

On Macintosh 



Find Bugs Fasl 

Spotlight is the firsi Automatic Memory Debugger tor the 
Macintosh, Instantly detect invalid memory accesses, had 
toolbox parameters, leaks, stack overwrites, memory reloca¬ 
tion problems, and much more. 

Spotlight uses your XSYM file to automatically patch your 
application no need to change your source code. No need 
to recompile. No learning curve whatsoever. 

The interface gives yiHj instant feedhack when an error Is 
deletled. You can ignore the error, ignore all future occurrences 
of the error, or bg the emir to a text file fur later analysis. 

Fine Grained Memory Protection 

Spotlight identifies reads and writes outside of the applica¬ 
tion and system heap. But it does not stop there. Spotlight’s 
ObjectGxk Replacement instrumentation inspects each read 
and write instruction in your code, detecting faulty memory 
reads and writes that occur between Mocks, in released blocks, 
across multiple blocks, and in ROM. 

This technology works on any heap object you can allo¬ 
cate; Mac heap objects, C'malloc* heap objects, even C++ 
objects created with new. 

Spotlight stops yuur application whenever a faulty memory 
access is about to occur and displays the exact source code 
line where it will happen. The calling stack is shown along 
with a display of all variables. A memory viewer shows rhe 
erroneous memory address and contents. 

Toolbox Validation 

Spotlight checks parameters to over 400 toolbox API calls, 
automatically validating handles, memory blocks, return val¬ 
ues, and so on. Specific checks catch subtle errors such as drawl¬ 
ing into an unlocked GWorld, passing an invalid window 


pointer, passing an address within an unlocked handle to a 
routine that may move memory, and too many more to list. 

Leak Delection 

No more struggling with MacsBug. On program exit Spot¬ 
light provides a clear listing of all leaked memory showing a 
full stack trace from where the memory was allocated. Instantly 
discover all leaked Mac OS objects, mallocM objects, 
C++ objects, and resources. 

Limitations 

Spotlight requires an XSYMfile to function. MPW and 
CodeWamor users can generate ihese directly. Symantec us¬ 
ers must use Tool Server to link with an XSYM capable linker. 
Spotliglu requires a PowerPC processor. 

Spotlight works on the object axle. No source code is re¬ 
quired: just the thing for resting purchased dard party libraries. 

Availability and Pricing 

Pric ing for Spotlight DR I is $ 199 US (plus $5 shipping and 
handling within rhe continental US, $15 for international 
orders). This includes a free upgrade to the GM version and 
access to ftp interim upgrades leading up to GM. QC users can 
cross-grade to Spotlight for only $149, 

All Onyx products carry a 30 day no questions asked money 
back guarantee. 

Onyx Technology, Inc. 

7811 27th Avenue West 
Bradenton, Florida 34209 

sa les^fc my x - tech .com w ww.onyx - tech com 

941 795-7801 941 795-5901 (fox) 



Spi*Lichr fi»J UU ore tr.nJettiLtrU itf Uii^t Ik Imuln^y. Inc, All nfh?r mvi*: marts hr? pmificny of tlioir rctgjn.irvtr iwmcr*. 








Build great applications... BcttGF 

f Great ( GoQd'nuf ) 83p6f _ 

Faster! 

Tools Plus 


LIBRARIES + FRAMEWORK 


Make codI apps while others are still reading their manuals* 
Professionally polished. Wickedly fast. Delightfully efficient. 


", . the routines are more compact and faster 
than anything you might write*** fiver}'element 
of Tools Plus is useful..* a bargain compared 
with coding these routines yourself " 

mt 


You build the interface. 

Tools Plus provides the infrastructure. 

It makes all your pieces work together as an application. 
With only a few hundred routines. Tools Plus thins your code 
by tens of thousands of lines. You see results sooner. 
Changes are a snap, 

"All in all an incredibly rich collection of took... 

If you are interested in developing applications 
that have 'quality' written all over them, then 
roofs Plus is for you ." MacTech MAGAZINE 

Yes, Tools Plus has it! 

* Create any element using a single rouline 

* Everything works as soon as you create it 

* Automates all standard GUI elements 

* Windows. Tool bar and floating palettes 

* Buttons (all kinds, flat and JO) 

* Scroll bars (speed control, live scrolling! 

* Wurld-dass custom controls 

* fields (w/scroll bars, fillers, auto-editing! 

* Picture bullous dhe best anywhere) 

* List boxes 

* CDEF and LDEF automation 

* Cursors (color, animated, juto-change) 

* Menus (put(-down, hierarchical pO|Mip! 

* Edit menu lundo/redo, automatic editing} 

* Panels (JL>. group boxes, lines, panes} 

* 3D titles (raised or inset! 

* Extended multi-monitor and color support 

* Clipboard automal ion 

* Dynamic alerts (no resources required) 

* Evcnl processing automation 

* Over 5DDK of custom fonts, icons, cursors, 
and other useful resources 

Plus thousands more exciting features and services! 
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prevXYfOl - 0.0: prcvXY[l] = 0.0: 
xylOl - 1.0; xyfll - 1.0: 

cutrIndex * 0; 
prevTndex = -1; 
iflag = 6: 

DrawKernel(g): 
icur = Math.max(l* 

Hath.min((int) Hath, f loo rUy [0]), xSteps)); 
jcur = Math.maxd , 

Math.min ((Int)Malh. floor (xy [ 1J). ySteps) ) ; 
ibkey - 0; 
i j [0] = icur; 

ij[ll ^ jcur; 

if (Routine_label_020f) && 

Routine label_l5fl()) return; 
if ( Routine label_05Q()) return; 
while (true) \ 

DetectBoundaryU: 
if (jump) ( 
if (ix I- 0) 

iflag “ 4; //Finish cnnmurai boundary 
ledge - ks t 2; 

if (iedge >4) ledge " ledge 4: 
intersect[ledge 1] = intersect[ks-1j; 
val_label_200 = Routine_label_20G(g,workspace); 
if (val_label_200 = 1) 1 
if ( Routine_Iabel_020() && 

Routine.label ISOC)J return; 

If (Routine IabeL_05OO) return; 
continue; 

J 

if (val_Iabel_200 “ 2) continue: 
return; 

I 

if (Ux ! m 3) && (ix+ibkey !- 0) && 

CtossedByContour(wo rKSpnce)) I 

if 

//An acceptable line segment has been found. 

// Follow contour until it bits a boundary or closes, 

// 

iedge - elle + 1; 

cval “ cv[cntrIndex); 

if [ix 1“ 1) iedge " lodge + 2; 

iflag ” 7 + ibkey: 

intersect[iedge ij * (aval - zl) t (z2 - xl); 
val_label_2O0 = Routine.label 200(g.workspace); 
if (val_iabei_200 — 1} I 
if (Routine label 020 0 ^ 

Routine labi*l_150( )) return; 
if ( Routlue_labol_05Q()) return: 
continue; 

I 

if (val_labei_2O0 “ 2) continue; 
return: 

I 

if (++elle >01 
elle = Idir % 2; 

ij(elle) ” slgndij telle j ,11 [k-lj) : 
if (Routlne_label_liO()) return: 

) 

if [Routine_labei_050O) return; 

) 

) 

// ------ 

//'painr overrides the Mipcrdass' 1 'pintO" method This method draws the grid and 
// then the contours, provided that the first two contour values are not equal 
//(which would indicate invalid data). The "workspace" is used to remember whkh 
// segments in the grid have l>ccn crossed hy which contours. 

public void paint(Graphics g) 

1 

int workLcngili *> 2 * xStepe * ySteps * nev; 
boo lean wo r k S pa c e | J: // Allocate Inrlow if data valid 

SetHeasureuteittsO ; 

DrawGrid(g); 

if fcvf31 !- cv[l]) I //Validdata 

workspace ~ new boo]can[workkengthj; 

ContourFlotKcniel(g s workspace): 

I 
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// ^ParsuZedMatrix K parsed the matrix of t values 
H which it expects to find in the siring V, 

public void ParseStedMatrix(String s) 

throws EarseMaU ixExceptian, lOException 

I 

StringBufferlnputStream i; 

StreamTokenizer t; 

i = new StrtngBufferlnputStreamfs) ; 
t = new StresmTokeniser (i); 

z = null; //Junk any existing matrix 
EatCharacter[t ,QFEN„SUI7K); 
do ParseftowVector(t): 
while (-t.nextTokenO = HE1'WEEN_ARGS): 

If (retype != CLOSE„SUITE) I 
1 rival IdDataU : 

throw new ParseMatrixRxception{ 

ContourPlotApplet,errParse + EQL + 

Contour PI o t Ap p le t. e r rKx pec t +(char) CLOSE J5U1 TL‘); 

! f (t, next Token () 1= t/iT_EOP) I 

InvalidBataQ ; 

throw new FaraeMatrixException( 

ConLourl'lor Applet. errParse + EOL + 
CoritourPlotApplet.errEOF): 

I 

HakeMat rixRee tangular {}: 

GetExtremesO ; 

if (xHajl > 2. MAX_MAX) zHax - Z_MAX_MAX: 

If (zMin < Z MIN MIN) zMn - Z_MN_MTN; 

AssigiiConLmirValuesf) ; 


//‘’ParscRmvVector" parses a row of data from the stream. 


public void Pa rseRowVector(StreamTokeuizer r) 
throws ParncMatrixException, IOException 
! // Parse a row of float's and 
// insert them in a now row of z[||] 

If (z — null) z = new floatfllfl; 
else AddRovC); 

Rat.Character (t .OPEN_St)lTE): 
do J 

if (L.nexiTokenO — t,TT_NUHBER) I 
int x ^ n.length - 1; 

if UlxJ ” null) ! 
z]xj - new float[1 ]; 
zfxllGl * {float)t.nval: 

1 

c1 so Add Column{(float)t.aval): 

I 

else I 

int x * z . length t; 
int y * z[xj ,length 1; 

TnvalidData(); 

throw new ParseMatrixException( 

Con lourPI nrApplet.errParse + EOL + 

ContourPlolAppIet,e*rr€omp + " [ w + 

Integer,toStr f iig(x) 4 * . “ t 
Integer.toString(y) + "1“): 

I 

I while (t.nextTokenO “ bK'l'VEEN.ARGS): 
if (r.tryju» 1 = CLOSE.SNITE) f 
InvalidDataO ; 

throw new PurnoMstrixException( 

Contourl’lot Appl el. err Parse I EOL + 

ContourPlotApplGL.nrrRxpact I(char)CLOSE.SUITE); 

f 


// "AddRow’ appends a new empty row to the end oPif 

public void AddRowE) throws FarseMairIxException ( 
int long = z,length: 
float tempi] [J : 

if {leng >= CoutourPlotApplet.MAX.X^STEPS) 
throw new ParsettatHxExeeption( 

ContourPlotApplet.errParse 4 EOL + 
ContourPlotApplet. errfiaurids) : 
temp * new float[leng+1] [J; 

System.arrayropy{z ( 0, temp* 0, leng): 

% = temp; 


//-----—- 

//'AridOdumn" appends "val“ to end of last row in V 

public void AddColumn{float val) 
throws FarseMatrIxException 

l 

int i * z,length 1: 
int long = z 1 ij.length; 
float tempi]: 

if (leng >- ContourPlotApplet.MAX_^STEPS) 
throw new ParseMatrixException( 

ContourPloiAppier.errParse + EOL + 
ContourPlotApplet.errBounda); 
temp “ new float[leiig+l]: 
Syfitem.arraycopyCz [i] . 0, temp* 0* leng): 
temp[leugl = val; 
z[i] “ temp: 


// ‘ MakcMatrixRcetangiilar* appends zeroes) to tin; cud of 
// any row iifV wiiidi is shorter than ihe longest row. 

pubUr void MakeMatrixRectangular() [ 
int i*y*leng: 

xSteps ^ z. length; 

yStepa - ContourFluLApplet.MIN Y STEPS: 
for (i - 0: i < xSteps: 1++) I 
y * 3tIi 1 .length: 
if tySteps < y) ySteps “ y: 

1 

for (i « 0; i < xSteps: i++) ( 
leng * z[i]* length: 
if {leng < ySteps) l 

float tempi] = new float[ySteps|; 

System.arrayC0py(z[i| . 0. temp. 0. leng); 
while fleng < ySteps) temp[leng++] w 0: 
z[ij = Lump; 

) 

) 

) 

// ‘RcturnZcttMatrix’ returns n hiring containing the 
// values in "z" for display in the results area. 

public String ReturnZodMarrixt) { 

String s,oneValue: 
int i.j: 
s - new String£ 

ContourPlotApplet,infoStrX 4 xSteps + K0L 1 
ContourPlotAppier.infoStrY +■ yStepa + EOL); 
for (1 a 0; i < xStepa: i++) | 
for (j = 0: j < ySteps: j44) 1 

oneValue = Duublc*roString(z(i| |jJ): 
while (oneValue,lengthO < NHMBER„LENGTH) 
oneValue - “ " + mieValue; 
s ^ s i oneValue: 
if [j < ySteps-1) s - s + * 

1 

fi = & + EOL; 

J 

return s; 

j 
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if ----——---- 

//"EttChaiaocr' skips any BLANK, s Ln tilt stream amt 
// expects ihe diameterMlIfowim; an exception If 
// the next non fltANK character Ls not *c". 

//------------- 

public void EatChameter (St reainl'okeriiser t H int c) 
throws FarseMat r \ ^Exception, IQException 

( 

while ft.nextToken() ~ BLANK) ; 
if (t .ttype !=■ c) I 
TrwalidDataU; 

throw new FarseMatrixF.xrept Lon( 

ContourPIotApplet.errFarse + EOL + 

ContourPlotApplet *crrExpect + (char)c); 

i 

I 

I 

Parse IV! atr ixExcept ioaj a va 

ParseMatrixException, a very' small class whose source code is 
shown in Listing 5. extends java.tang. Exception and is used to throw 
exceptions when any error occurs during parsing of the matrix of 
z values. It contains no new data members and its only method is 
a constructor taking a single String argument whose contents 
explain the error The applet catches this exception and displays 
the string in the results box. The various explanatory strings are 
built from arguments read from the <APPLET> rag in the html file 
and stored as static String objects in ContourPlotApplel, 

listing 5 

Ptirsi M;i itixExceptkm. java 

// Class “nirscMairixException” is used tr> signal an error corresponding to invalid 
// data encounitrcdwhen parsing the matrix of / values. 

publir class Par^eMa i rixException extends Exception I 

public FarseMatrixException(Strfng message) I 
super(message); 

I 

1 

Conclusion 

This article has presented a reasonably simple Java applet 
which nevertheless performs a useful function. It illustrates a 
variety of features of the java language, such as: 

* constants, that is, final static data members; 

* class (static) methods (See, for example, Float.toString called 
by GetContourValuesStnng or Math.logQ called by 
AssignContourValues, in Listing 4.); 

* manipulation of characters strings using the String object; 

* parsing data by breaking it into tokens (see ParseZedMatrixQ 
in Listing 4); 

* sending output to the Java console (sec DrawTheContourPlot 
in listing 2); 

* several user-interface components (see the data members in 
listing 2); 

* interfaces and a custom layout (see Listing 3); 

* a custom component (see Listing 4); 

* arrays of one or two dimensions (see, for example, data 
member z in Listing 4); 

* applet parameters (see Listing 1 and init(} in Listing 2); 

* a little colour (see DrawGrid and SetColour in Listing 4); 


* throwing and catching exceptions (see Par$eZedMatrix() in 
Listing 4 and DrawTheContourPlot in Listing 2); custom 
exceptions (see Listing 5); etc. 

For the reader who would like to experiment with possible 
improvements to this applet, here are a few suggestions: 

* allow user-input of the number of contour values, or of the 
contour values themselves; 

■ implement a file dialogue so the user can read a matrix of 
data from a disk file; 

* shade the regions between contours; 

* allow the option of keeping grid cells square when the 
number of rows does not equal die number of columns 
thus requiring a non-rectangular drawing area; 

* allow user-input of die grid values — Le. x and y values — 
so that the grid lines need not be equally spaced. 

* for the ambitious: parse a closed-form expression such as z - 
sin(x y) t then generate the grit] values — choosing the 
fineness of the grid according to the absolute values of the 
partial derivatives of z — and finally plot the result; 

* again, for die ambitious: implement Preusser*s algorithm, for 
nice smooth curves! 

The contour plotting applet (not necessarily the version 
described in this article, but similar) may be viewed by pointing 
your well browser U> 

<http://www.CR M. U Montrealn CA/Ga lerie/ContourP1otApplet_Eng. html >, 
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ALTERNATIVE 

ENVIRONMENTS 


by Walt Brainerd, David Epstein and Richard Hendrickson 

The F Programming Language 
Tastes Like Java 


F is a new programming 
language derived from 
Fortran in much the way 
Java is derived from C 


Introduction 

This article describes the startling 
comeback of Fortran by discussing the 
features found in the V subset of Fortran 95 
comparing them with the features found in 
Java, The combined strengths of Java and 
the F programming language make a 
wonderful introduction for beginners and 
a powerful package for professional 
programmers working on large projects. 
Even people familiar with modern Fortran 
and Java are unlikely to have noticed the 
benefits of combining the two. 

Both languages claim multi-platform 
portability. Java capitalizes on the look and 
feel of C++ while aiming at professional 
programmers- F capitalizes on die 
efficiency and pedagogical design of 
Fortran 95 while aiming at teenage 
beginners, experienced scientists, 
engineers and large teams of programmers, 
Java offers powerful object-oriented 
capabilities familiar to the C++ community; 


F offers organized module-oriented capabilities familiar to the 
Fortran 95 community. 

Getting over the initial shock that Fortran is not all that 
different from Java can be a stretch for any programmer not in a 
coma since 1995. The amazing similarities surprised even die 
authors, who had brought together over four decades of Fortran 
language design committee experience to create F while the 
Green team was creating Java. 

The simple step taken by both language design teams is a 
move away from procedures as a first class citizen and die 
insistence that procedures lie encapsulated inside a more 
powerful mechanism — a class in Java and a module in F. 

After comparing the features of F and Java, we suggest some 
benefits of combining F and Java for introductory programming 
instruction as well as for large professional projects and 
efficiency driven applications. 

A Binary Tree 

An example may help to show die similarities between F 
and Java. Listing 1 shows a binary tree written in both F and Java. 
Notice that the mythical phrase, "Java does not have pointers," is 
better said as, "Java does not support the dangerous pointer 
arithmetic found in C and C++, 5 ' 

The tree is made possible by the below statements dial 
declare a recursive type: 

type (node), pointer i: left, right ! found inside F *node M 
tree left, right; // found itteidc Java ’Tree 1 ’ 

In F, the word “pointer’' is actually used in the declaration of 
the "nested defined type;” in java, the word “pointer" is not used 
in the declaration of the “nested class." 


Walt Brainerd <wall@imaginel.c©m> is co-author of about a dozen programming books. He has been 
involved in Fortran development and standardization for over 25 years and was Director of Technical Work for 
Lhe Fortran 90 standard. 

David Epstein <david@imagincl.com> is the project editor of Part 3 of the Fortran standard regarding 
conditional compilation. He is the developer of the Expression Validation Test Suite (FVT) for Fortran compilers 
and author of the book Introduction to Programming with F, 

Dick Hendrickson <dick@imagmcLcom> has worked on Fortran compiler development in both educational 
and industrial environments since 1963, lie currently is a consultant on compiler optimization and one of the 
developers of SHAPE, a test suite for Fortran compilers. 
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Listing I: BinTree.f and BinTreeJ 


A binary croc written in F is easily translated into Java, 

! A Binary Tree in F //A BmaiyTrce Id Java 

module m_Mnary_tr*e class Tree l 

public :: main. Insert * FrioCTree 
private NewTree 
type, public :: node 

integer :: value int value; 

type (nude), pointer :: left, right Tree left, tight; 
endtype node 
contains 

function NevTree(num) 
integer, intent(in) 
type (node). pointer 
allocate (tree) 
tree%value * num value “ num: 

nullify(tree*left) left * null; 

nullify(treetttight) right - null; 

end function NewTree f //Constructor 


SinaryTrec 


raeult(lree) 
: num 
;: tree 


Tree 

int 


( 

num) 


recursive subroutine InsertUree, nun) 
type (node), pointer t: tree 
integer, intent(in) ;; nun 
if (.not. associated (tree)) then 
tree - NevTree (mt») 
elseif (num < treeUvalue) then 
<tree,value)I 

call Insert(tra*lleft) 


else 

call Insert(tr«%right) 
tree.right m Insert 


endif 

routine Insert 


static Tree Insert( 
Tree tree, 
lot num) ( 
if {t£ee“niill) ( 
return new Tree(num); 
)elseif(num 


tree.left ■* Insert 
(tree.left, nun); 
return tree; 

J else I 


(tree.right, num); 
return tree; 

I //if 
I //insert 


recursive subroutine FtintTree{Lrea) 
PrintTree( 

type (node), pointer :: tree 
if (associated (true)) then 
call PrititTrep (treelleft) 

P tintTree{t ree,Ie ft): 

print *, tree%value 

call PrlntTree (l%rlght) 
PrintTtee(tree.right); 
endif 

endsubroutine FHntTree 


static void 

Tree tree) I 
if (tree 1= null) I 


System, out .pH nt 1 n 

(tree,value); 


\ffit 

I //PrimTree 


subroutine main 

type (node), pointei tree 

integer ;; i 

nullify (Lieu) 

print *, "Unsortedi list* 

do i - 1, 30, 3 

print * h modulo(1,10) 


Knddo 

print \ “Sorted list" 

call print_tree (tree) 
eodsubroutlne main 
endmodule m_tree_ESort 


public static void 
main (String argv(l) I 
Tree tree; 
int i; 

tree = null; 

System,out.printIn 
(“llnsortctl list*); 
for (i=I; i<3*10; i-i+3)l 

System,out.printIn 
U*1Q): 

tcee ■ insert 

(tree. 1*10}i 

I//for 

System.out..print! n 
("Sorted Itsf); 
Printiree(tree); 
]//main 
I//Tree 


call ineert(ttoe, modulo(i,10)) 


program tree sort 
use m tree .sort 
call main() 
endprogran tree_aort 


fn F, pointers only can point to objects tliat are targets; Ln Java, 
everything is being pointed to T even procedures. A non- 
mainstream view of Java is not that there are no pointers, but that 
everything in Java is being pointed to. 

The F Programming Language 

We expect the average reader to lx 1 more familiar with Java 
than with the F programming language. Thus, an introduction to 
some of the F programming language is called for. 

One major difference between F and java is that Java 
technology often refers to much more Lhan a programming 
language — the class hierarchy from which all objects are derived, 
die Java Virtual Machine (JVM), bytecode and Just-In-Time 
compilers, to name just a few. F, on the other hand, does not have 
a standard module hierarchy or set of software tools considered 
part of the F technology other than the F compilers. Thus, this 
overview of F is a description of the F programming language. For 
those seeking more specifies, the grammar for F (in BNF) can be 
found on the Imagine 1 web page (listed at the end of Litis article). 

F Statements 

Figure 1 categorizes all die F statements. Instead of calling 
a prcjcedure main as in Java, there is a single main program 
required in F and iL can be given any name. An F program can 
use modules and reference public procedures and ocher public 
entities from the used modules. Modules and their contained 
procedures can also use other modules, lliis creates module 
hierarchies whose roots are the modules that were used in die 
program. Using a module is similar to importing a package in 
Java, Both languages encourage a hierarchical organization. 



program 

use <nHsdule>.., module 
endprogram public proc-liat 

private :: prot'list 
contains 

<procs>,.......subroutine.,.,.,..function 

endtnadule use module use nodule 

end sub routine end f unctio n 

Action co ns tru c t s 

if / elsgif / .else / endif 

select .case / case / case default i ehdselect 
do / cycle i exit / enddo 
where / elsewhere / endwhere 

type integer character intrinsic interface 

end type real logical module procedure 

complex endtiuer face' • 

Actions 

“ (assignment-) allocate call stop 

(pointer assfgrtmenl) deallocate return 

Input/Output 

print open write inquire backspace 
read close rewind 

endfile 


Figure 1. Categorizing all the F statements. 

The strategy For pointers in F and Java is actually the same — 
no physical address is made available and wliat Is being pointed 
to must lie specified in the declaration (that is, no void pointers). 
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One design goal in F is to require explicit declarations for 
entities ;md not rely on any defaults. This is the opposite extreme 
from Lhe “old Fortran" with its implicit declaration of an integer 
by starting its name with the letter T as in 

itotal = 0 ! Declares an integer in earlier Fortrans 

One result of requiring everything to lx: explicitly stated is 
that the student's first module that contains a procedure will 
require a public statement. This leads into an early discussion of 
public and private if the instructor so chooses. 

Those challenged to make a thorough comparison of F and 
Java will notice that Java docs allow defaults and that the default 
for a function is protected. If Java were to employ the strategy used 
in F, die word protected would have to lx: specified explicitly. 


Hie F Attributes 

Figure 2 lists the attributes for F entities. A lade description 
of public and private is given here as these attributes differ 
slightly from the others. 


Attribute Description 


pointer 

public 

intent 


dimension 
a!lotstable 
parameter 
save 


target Pointers can only point at objects 
that are targets. 

private All module entities ate either 
public or private. 

All subroutine arguments must be declared as 
iptent in, out, or inout. 

Ail function arguments nuiat be intent in. 
Arrays can be from one i,o seven dimensions. 
For dynamic allocation. 

A constant. 

A static local variable. 


Figure 2 . Attributes for F entities. 


Procedures are listed in public or private statements in the 
module that defines them. All other module entities require a 
public or private attribute in their declaration statemenL One 
other use of the word “private" is to declare the components of 
a public defined type as private to the module. Such a module 
would supply its users wait access to the defined type and the 
procedures that operate on entities declared to lx: of this type. 
The insides of the type are hidden from the users of this module. 
An example of this can be seen in Listing 2 t which hides the 
internal parts of a car from its users. 

Listing 2: CarModule.f 

(arModuk' 

Tills cir module exports a cy|x- ihat has privaie components 

module m_cair 
use m .engine 

private I do not export entities from module m engine 
public :: GetCarlnfo 3. ♦», public prycu listed here 
private a IncroiiseCost I, ... private proes listed liere 
type, public :: t_car 

private ! component® are private to this module 
type (t_engine) :s engine ! r_otrgine from m^engine 
integer :: cost_of_engine 
Integer :: year 
endrype t_cat 
contains 

subroutine GetCarTnfo(engine, year) 

! ... 

subroutine increaseCosit) 

1 ... 

endmodulfl m car 


The Fijndamentaj, DiFpeu^ai Between F and Java 

Although there are many similarities between F and java, 
there is one fundamental design difference and a few minor 
differences that deserve attention. 
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The fundamental difference between F and Java is the way 
in which modules and classes are accessed. In F, a module can 
be used, which makes its public entities available. There are two 
sorts of modules worth mentioning for this discussion: 

1. Declare actual data entities to be shared amongst its users. 

2 . Provide the definition of types and procedures that operate 
on those types, requiring the users to declare the actual data 
entities, and call procedures accordingly. 

In Java, a class can be imported, making its definition available 
for instantiations. TTiis is similar to die second sort of F module 
listed above. Namely, the Java class definition provides a type and 
procedures that operate on that type, bur it is left to the importer 
of this class to create instantiations and call procedures accordingly. 

Although modules are similar to classes, the fact thaL 
modules are used instead of instantiated leads to a slight shift in 
organizational thinking. For example, if SetSalary is a procedure 
that sets the salary of an employee, and employee is part of a 
person, a Java reference may look like 

ariEmployee.SetSalary (100); 

and an F reference may lock like 

call SetSalary (anEmployee * 100) 

In Java, an Employee would automatically inherit the 
features of a person; in F, ft is up to the designer of the employee 
module to use the person module and make appropriate features 
of a person available to employees. For example, if Gender is a 
feature of a person, a Java reference may look like 

anEmployee.GetGender0 i 

and an F reference may look like 

Ge t Etnp 1 oy eeGe tid e r (anEtnp 1 aye e) 

Name Space 

F references do not use dot notation. Tim presents a 
possible name space problem because the same name cannot lx* 
public in more than one used module within Lhe scope of the use 
statements, lhe solution for tills in F Ls die feature to rename 
used entities. For example, 

use employee_module. sl^>salary 

makes the salary entity of the employee_module available only 
as the name si in the scope of this use statement. 

Cats, Dogs, and Mammals 

A more philosophical view of comparing module-oriented 
programming and object-oriented programming cun be shown using 
the example of cats and dogs. One argument for object-oriented 
programming is that humans see the world in terms of objects 
instead of in terms of actions. We see cats and dogs instead of 
GiveBaih, iluntBiitl, WagTail and SniffHand. This argument also 
holds for module-oriented programming with the word "module* 
replacing the word “object" — humans see the world in terms of 
modules instead of in term of actions. Seeing cats and dogs as 
modules means viewing them as concepts which liave definitions; ii 
Ls possible to have an actual cat or dog object, but it is also passible 
to talk aix^ul them without having to create an instance of cat or dog. 


The implementation difference can be found by taking a 
closer look at the writing and accessing of cats and dogs. In F, 
the implementor of cats and dogs can decide to use mammals to 
gain access to concepts common to all mammals. An F cat 
module cannot, however, export the mammal public entities. If 
the cat module wants to export a trail common to mammals such 
as SuckMlk, the implementor of the cat module must do some 
work to make this happen. In Java, when die cat class inherits 
from the mammal class, the cat class automatically exports all the 
public concepts of the mammal class. The access to cats in F is 
done by using the cat module and possibly calling 
KittenSucksMilkCaCat). The access to cars in Java is done by 
instantiating a cat and possibly calling aCauSuckMilk. 

Both methods have their advantages and disadvantages. Do 
you see cats and dogs or do you see mammals that are cats and 
dogs? In F, the designer of cats and dogs decides if it is important 
that they are mammals; in Java, the user of cats and dogs must 
understand that they are mammals. 

Other Differences Between F and Java 

Having hurdled rhe fundamental difference of using 
modules versus instantiadng classes, other differences are minor 
jumps by comparison. 

1. Intrinsic Procedures Versus Standard Libraries 

2. F provides more than one hundred intrinsic procedures such 
as cos, tan, len and daie.andjime. These intrinsic procedures 
are part of the F programming language and not part of a 
standard module that must lx included or is implicitly 
included. Java provides much more than intrinsic procedures 
with its class hierarchy providing “standard* libraries for GUI 
building, exception handling, graphics, networking, multi¬ 
threading and coercion (such as integers to characters). This 
Java library will surely expand for whatever else becomes 
important (such as multimedia). To reference these goodies, 
the appropriate classes or packages must lx: imported. A 
wildcard of "* M can lx used to import everything at die 
expense of size and speed of die application. 

Overloaded Operators and Overloading Procedures 

Both F and java support using the same generic name to 
reference one of a group of specific procedures. Listing 3 shows 
overloading the swap for the F intrinsic types. Overloading 
operators is a different story. 

listing 3 ; 5 wap*f 

SwapModuk 

This module overloads lhe name swap" for all the intrinsic types. 

module swap_module 
public :: swap 

Interface swap 

module procedure iut_swap, real_svap. complex^swap, & 
logical_svap* character,.swap 
end interface Sswap 

contains 
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subroutine int^swap (a.b) 
integer, intent fin out) s,b 
integer ;; t 

t - a 
a = b 
b * t 

end subroutine inswap 

subroutine teai_swap Ea,b) 
real, intent(in out) :: a.b 
real :: t 

t " 0 
a * b 
b " t 

endsubroutine real_swap 

subroutine complex_svap (a.b) 
complex, intent(in out) t: a.b 
complex :: t 

t * a 
a = b 
b = t 

endsubroutine complexeswap 

subroutine iogicai_swap (a.b) 
logical, intent(in out) a.b 
logical :: t 

t = a 
a = b 

b - t 

endaubroutine logical_swap 

subroutine character_swap (a*b) 
character (len^*)• intent(in out) a.b 
characterClcn”l) :: t 

if (len(a) =* lcn(b) ) then 
do i = 1. lenfa) 
t - a(i:i) 
a(i;i) - b(i:i) 
bU:i) - t 
end do 
else 

print ‘ ■ “‘Length of character strings differ." 
print *, ‘Can not swap-* 
stop 
end if 

endsubroutine character.swap 

end module swap.modulo 

program try_svap 
use swap routines 
Integer 11, i2 
character (len"!6) :: cl* c2 

11 - 10 
12 - 20 
el “ "stringl" 
c2 "the other string" 

print *, "il and 12 before swap** il, 12 
call swap (il* 12) 

print *, “il and 12 after swap", il, i2 

print *, "cl and c2 before swap>", ci,*< >"» c2,"<" 
call swap [cl, c2) 

print *. "cl and c2 after swap>*\ cl,"C > M , c2,"<* 
end program try_swap 


F provides the ability to overload the intrinsic operators as 
long as the operators are not already pan of F. For example, w +* 
can be overloaded to operate on Lwo characters bur it cannot be 
overloaded to operate on two integers l^ecause this would replace 
the intrinsic addition operation already found in F. F also provides 
the ability to create your own unary and binary operators as long 
as they are given names surrounded by dots as in ".inverse.". 
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When overloading a name or an operator, all desired 
permutations of intrinsic and user defined types must be listed so 
that resolution to a specific Junction is always known at compile 
time; there are no run time resolutions in F, We can only guess 
that the Green team decided to do away with overloading 
operators out of die frustration created by C++ when a 
programmer attempts to figure out what AO+BO actually means. 
With its virtual functions, the expression AO+BO in C++ could be 
anything from a simple addition to a call to practically any 
function, Il may require a thorough understanding of the design 
and most of the code to be sure exactly what AO+BO means, in 
F, one can conceivably click the *+" and be directed to the 
specific function that is being referenced. 

Kinds Versus Specific Arithmetic 

Java solves the non-portability created by different 
machine's mathematical models by requiring a specified range 
and precision for each type; if machines do not match this 
mathematical rrKxlel, they must emulate it. F solves litis same 
problem by allowing specifications of different kinds for types 
and literals, A kind number can be determined using the intrinsic 
procedures. For example, die expression 

selected_real_kind(10.50) 

returns a kind number to specify variables to have at least 10 
digits of precision and an exponent range of at least 50. The kind 
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number is then used in the declaration. Fur example: 

module kiud_module 
integer, public, parameter :: k 
klQ_50 a selected tee 1_k1nd£10*50] 
endmodule kind module 

modale m_do_$ome L h i n g_wit h_my_iioat 

use kind_module 

private f do not export entities from kind module 
teal (kind = klO_5G). public :: nFy_float 
I ... 

endmodule Ts_do_ someth! ng_wirh_my_float 

End-Of-Line Versus Semicolons 

Unlike C, C++ and Java, statements in F conclude at the end- 
of-line unless an ampersand (&) is placed at the end-of-line to 
signal that this statement continues on the next line. Considering 
that most statements fit on one line, we feel that this design is 
easier for students to learn and less error-prone for both 
beginners and professionals. This may lie a small point as todays 
C, C++ and Java programmers have obviously learned to cope 
with semicolons and since they are required inside certain 
statements (like the for statement) it appears that the Java 
designers had no choice. 

Emphasis On Safety and Readability 

The final difference between F ami Java that we would like 
to mention is the overall strategy of safety and readability that 
was carefully designed into R One way to compare this with the 
overall strategy of the 'look-and feel like C++" carefully designed 
into Java is that the F design is less marketable to today's 
programmers. Unfortunately for the software crisis, there are 
plenty more C++ programmers in the world than there arc 
programmers dial want to follow particular style guidelines. 

For example, programmers with a preference for a one-line if 
statement do not cane for the idea in F of requiring an endif 
statement. The required t Tend if pair may lead to clearer blocks of 
axle and unambiguous else statements, but more importantly it 
exemplifies the design strategy in F that abbruv.R!++ (abbreviations 
are not good). Requiring an endif statement in F sometimes means 
splitting one longer statement into three shorter statements by 
adding two words "then" and “endif*. These words are important 
for error detection as well as tool writing, A missing parenthesis is 
easier to report if the reserved word Then" is required and a path 
coverage tool is easier to write if the word “endif' is required. 

Our claim is that the safety and readability required of F 
code aid students and professionals. Possibly the best example of 
i he safety designed into F is the intrinsic statement, intrinsic 
procedures in F are allowed to be overloaded as long as the 
argument types differ from those found as part of lire F language 
definition. For example, cos am be overloaded to accept a 
character argument but it cannot be overloaded to accept a real 
argument. Since there are so many intrinsic procedures, we 
decided that overloading one of them requires listing the name 
of the intrinsic on an intrinsic statement. This prevents the 
unknowing programmer from creating an involved module using 
a name that is already part of the language. Without this 
requirement, it would have been possible to overload cos, 


presume a reference to it, accidentally use the wrong argument 
and wind up referencing the intrinsic without ever realizing it. 

Attention Teachers and Beginners 

Data Encapsulation 

It seems Lhat righi now everybody on the planet is interested 
in learning Java. Java has become so popular that many colleges 
and high schools are dropping Pascal and throwing beginners 
directly into Java. Though we believe Java is much more 
structured and friendly than C++, the fact remains that beginners 
need nurturing error messages more than the semester's 
survivors need the promise of a potential summer job. Indeed, 
good teachers can teach anything and good students can leant 
anything, but F offers a chance for those in the middle of the bell 
curve to learn how to program. 

F jumps in Ixnween the academic emphasis of Pascal and 
the professional look and feel of Java to offer a compromise 
designed for both camps and ideally suited for potential 
engineers and scientists. The most attractive feature of object- 
oriented programming for beginning programming courses is 
data encapsulation. With its module-oriented programming, ¥ is 
ideally suited for teaching and learning data encapsulation 
without getting lost in complicated inheritance chains. 

Nurturing Versus $ink-or-Swim 

Keep in mind that pure beginners have dozens of skills to 
learn, including: 

* an editor (as well as using a keyboard), 

* an operating system or environment, 

* language syntax, 

* deciphering cryptic compiler (or linker) error messages, 

* save, compile and link commands or save and run commands, 

* errors in logic, and last but not least 

* programming concepts. 

Minimizing the impact of this list was built into the design of 
F. On top of the F programming language sits a tutor/environmeni 
called F world, F_world guides die pure beginner through writing 
and running their first F program. Tills program adds numbers until 
a zero is entered, uses a module with a subroutine, requires a kx>p 
and an if block and introduces one half of the V statements. 
Although this sounds complicated, ii consistently creates 
programmers ranging from age eight to eighty in less Lhan an hour. 
Listing i shows the statements that are fed one at a time to the 
beginner and a possible solution if the suggested names are copied. 

listing 4: E_workLf 

F_w>rldBegtnncr 

flic J- world tutors beginning program template and the suggested solution. 

program __ 

use __ 

call _ 

endptogram _ _ 

f This module is entered into its own window 

module _ 

public ;: __ 
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contains 

subroutine _____ 

integer i: _. 

integer _ 

do 

print ___ 

read _ 

if ___ than 

exit 

else 


print______ 

etidif 

enddo 

print ____ 

endsubroutine __ 

nndmodule _ 

! If rhe example names are used, here la the resulting F code 
program MyFiratProgram 
use Myt'irstModul c 
call HyFirstSubroulIneE) 
endprogram MyFirstProgram 

1 This module is entered into its own window 
module MyFiratModule 
public :: MyFirntSubroutine 
contains 

a ubroutine My FIr s t S ub routine{) 
integer :: input_number 
integer :: curreriL^toial 
current-total * 0 
do 

print *. '‘Enter number to add, or 0 to exit:" 
read input number 
if (inpui_mimher = 0) then 
exit 
else 

current-total - current-total 4 input_number 
print 4 , ■‘the current total 1 $: ", currents Ota 1 
end i f 
enddo 

print ** "Goodbye for now, 4 * 
endsubroutine MyFIrstRubroutine 
endmodule MyjfirfitModule 


The F_world tutor uses the opposite strategy of “Hello 
World" and begins with a nontrivial example that can be used as 
a base for learning the basic concepts of programming in the first 
week if not in the first few hours. 

The words save, file, compile and link are not used in F_world. 
Modules are entered into “windows" and validated and programs 
are simply run. As with importing packages in Java, using modules 
in F is a compile time feature; F_world knows where to find the 
necessary modules and link" them with the program so the 
programmer does noi have to. In F, all procedure interfaces are 
checked at compile time; there ts no such thing as a linker error. 

Natural branches from the tutor's lieginning program include 
a description of the statements, loops, if-else decisions, programs, 
modules anti subroutines, variables (we call them “containers"), 
integer data type, input and output., Playing with the code easily 
introduces other data types such as reals, subtraction instead of 
addition, functions instead of subroutines, private versus public 
and passing arguments to and from procedures to name a few. 
This normally covers the bulk of a semester when following the 
agenda set for programming courses two decades ago; with 
F_worid we propose to cur this time in half, using the saved 
energy for more learning material or for learning Java! 
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Error Messages 

Another key design goal of F was to be able Lo give specific 
error messages in as many situations as possible. The result is a 
grammar with minimized token look ahead requirements and an 
emphasis on keywords instead of punctuation and abbreviations. 
Since most statements begin with a reserved word, which is 
followed by specific tokens, likely errors such as misspelled 
keywords can be dearly reported. For example: 

infger :: total 

| A A 

! ERROR (#41155) on line number: 5 HI It!!!!!!!!! III! 

■The word INTEGER is misspelled. M 

I M M! 111111 H 1U N M 11! It H 1 M U 1 M I 111 I 111 !H H ! 11 

Although sometimes trickier to diagnose, missing commas, 
colons and parentheses are for die most parr also dearly reported. 
Since compiler writers most often have their 1 amds full with simply 
getting the answers right, products for complicated programming 
languages often have few resources allocated to consistent and dear 
emir reporting and recovery. Indeed, writing and reviewing enor 
messages is often the last item “thrown in" I before product testing. 
For example, one author (DE) misspelled the word intger in his first 
program and required 24 hours and help fnjm another student to 
discover what “Bad statement syntax" meant when it was plac ed at 
tlie loginning of the one^mmeous^haracter Fortran 77 program. 
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Functions Arc Not Subroutines 

In F, procedures are either functions or subroutines. 
Functions are not permitted to have side effects so all arguments 
must be specified to have intent in. Subroutine arguments must 
be specified to have intent in, out, or incut. The attention given 
to argument intention and differentiating between functions and 
subroutines will surely help a student to understand what the 
word “void" means when placed in front of a Java function. In 
contrast, students loginning with Java will most likely think of 
void as required syntax until they are forced to learn its meaning 

From Supersets to Subset and Near Subset 
Another View of F 

It is not a coincidence that a language originally designed for 
non-computer scientists has benefits for both [beginners and 
professionals. Fortran's history lends over forty years of language 
evolution targeting engineefs/scientists/mathemaLidans/physi- 
dsts/chemists/etc The result is a language that contains a simplified 
syntax designed for problem solvers who do nest have the desire to 
learn excruciating details and pitfalls of the implementation 
language. Even with its target market of non-progranailers, Fortran 
95 can be considered overly complicated since it contains all of 
Fortran 77 along with the recent additions from the ‘80s and '90s. 

Tire mixture of the outdated 1977 features with the modern 
1995 features essentially makes for two complete languages; the now 
outdated language was even considered lacking when introduced 
two decades ago. By carefully selecting the simplest subset of Fortran 
95 without removing any desirable features, F presents an efficient 
package for people not wanting lo carry around the old baggage of 
Fortran 77. An F processor will not accept a Fortran 77 program. 

Another View of Java 

A similar story can be told for Java. The creator of C++ was not 
motivated (and actually found it inappropriate) to remove the 
undesirable Baggage C had been carrying around since the 70s. Hie 
creator of Java essentially had two complete languages to chisel into 
a smooth subset IxTore realizing that sculpting a new masterpiece 
(tetter fit his vision. Java is the first language in the evolution of C that 
emphasizes simplicity. A Java processor Will not accept a C program. 

Attention Professionals 

You have seen how a simplified grammar aids the lx.ginncr but 
may be wondering what are die advantages for the professional. If 
you have ever picked up tens or hundreds of thousands of lines of 
code tliat were written by "somebody else" you may recall Lhe pain 
related in simple tasks like finding the declaration of a variable or 
procedure. As business dictates, jxipular programming languages 
feed tool vendors with marketing ideas for reducing the pain of 
reading, updating and validating .somebody else’s code (if not your 
own). The.se tools, however, cost money and learning curve energy 
(often just to prove that the features you desired most will not be 
available until the next release of the tool). 


Finding Something 

While writing the F compiler front-end in F, we came across the 
need to find all array declarations, Ii did not Like long to realize that 
a search for the word “dimension” was all we needed. The number 
of occurrences of Lhe word “dimension” in quoted strings and 
comments w ere mre T but this potential problem when using a simple 
editor search is easily avoided by any serious programming team 
willing to spend a few days (or less) to write their own F scanner. 

Large Projects 

The idea of writing your own language tools designed for 
your specific project is powerful enough that we expect free F 
scanners written in F to become available soon. Given a tool that 
creates an array of tokens, finding all array declarations and other 
queries can be done with exactness. This exactness is required for 
accuracy of more involved homegrown projects such as profilers, 
static analyzers, test case coverage and test ease creation tools. 

Even without writing specific software tools, an editor is enough 
for large project programmers to benefit from the exactness requited 
in F. For example, a debugging session may lead to a screen of code 
that calls subroutines Hidden, FindMe and Where Ami The first 
occurrence of these names in this module will tel] if they ate local 
and, if they are local, whether they are public or private. 

It is quite convenient to discover that Hidden Is private to 
the current module because all references will tie found without 
having to open another window or file. This shows how the 
public and private differentiation aids with maintenance and 
code surfing as well as with design and encapsulation. Neither 
Fortran 77 nor C had the public and private differentiation. 

If FindMe is not local, a search for lhe string “subroutine 
FindMe M will likely find the declaration. As well, while looking at 
die code for FindMe, searching for the same string will likely find 
the endsubroutine statement. This is, of course, the benefit of 
using the word “endsubroutine” followed by the subroutine 
name instead of the character *T or the word “end". 

Finally, if finding “subroutine Where Am I” does not lead io 
[he procedure code, it will lead io the interface that declares this 
procedure to lx? code that is written in a programming language 
other than F such as Fortran, High Performance Fortran (HPF), C 
or Java. lhe ability to call non-F procedures is only available in 
the professional edition of the F compilers 

Portability and Standards 

The Fortran standard Is constantly I King updated with new 
features. As mentioned, this strictly enlarging nature of lhe Fortran 
standard can lead to an overly large language. Considering the 
alternative, undisciplined approach of creating languages and 
products before reaching a standardized consensus, Lhe 
standardization process is one of Fortran's strengths. 

Fortran vendors are relying on the standards teams and 
announcing new compilers only after the specifications have been 
accepted. Java’s forced mathematical module and the bytecode- 
JVM provides portability; Fortran's standard's work and Fs 
commitment to extract the safest features without compromising 
power provides both portability and efficiency. Before Fortran 
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2000, another push for portability is fxring made with the addition 
of Part 3 of the standard regarding conditional compilation. 

The Fixture 

Some may feel that a technology that comes as quickly as java 
is bound to disappear just as quickly. The authors see, however, 
that Java is an improvement to C++ and is bound to persist and 
evolve for decades. With the Fortran committee's current focus on 
more powerful object-oriented features in Fortran 2000, F Ls also 
positioned to persist and evolve for decades. 

Whether or not F can actually figure into the future of Java Ls yet 
to be seen. Java is currently lacking the efficiency that many knge 
projects demand and tire addition of JavaScript to the Java 
technology shows how quickly the Java folk are plugging m any 
existing holes. With four decades of compiler optimization backing 
Fortran, F surely presents the efficiency that Java lacks. Paradoxically 
the issue of efficiency usually involves the misconception that Java 
lacks pointers, but the dereferencing mechanism found in java is not 
all tliat different than the pointer-target mechanism found in F. 

Summary 

It is difficult to summarize this presumably shocking report 
that Java is not all that different than Fortran and its subset F. 
There are far too many similarities and differences between F 
and java to give a full detailed description in this article. We 
expect that this discussion has raised a few eyebrows. 

Scientists and engineers will no doulx find F to lx? a similar 
look and fed to Fortran 77 as computer scientists find when moving 
from C or C++ to Java. Fortran 77 programmers have some learning 
to do IxTorc writing F code and C programmers liave more learning 
Lo do tlmn C++ programmers before writing Java code. F is even 
more familiar to those rare Fortran 90/95 programmers since every 
F program is also a Fortran 90/95 program. 

A fitting ending to this F introduction and comparison to 
java may be the promise that the next generation of 
programmers, whether computer scientists or others, are learning 
well structured module-oriented and object-oriented techniques 
from the very start. This is accomplished by beginning with F and 
moving to Java, all in their first year of programming. As this 
scenario unfolds in the academic world, the average student and 
not just the “smart kids* can be given a chance to learn what 
programming is all about. After all, programming really is not all 
that difficult and it is finally becoming simpler. 
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Guess again. 

If you guessed that the first installer was 
built by Draglnstall, you’re only half right. 
Now with Draglnstall 3.0, you can build both 
of these installers from a single script file! 

For more information about Draglnstall 
and a free demo, visit our web site at 

http://www.sauers.com/draginstall 

or give us a call at 1 - 800 - 890 - 9880 . 
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JAVA 



by Andrew Downs 


Calling C Code from Java 


Using native code ivith 
Java applications and 
the Sun JDK 


Introduction 

'Itiis article shows how to access C 
code (also allied native code) from within 
Java code. The C axle exists as a PowerPC 
shared library containing several Process 
Manager calls. The functions in tire shared 
library are used to get and store process 
information, A java front-end calls the 
shared library at specified intervals to 
retrieve and display the process information. 
Timing for these calls is accomplished using 
a thread. The front-end also includes a 
preferences dialog with a pseudo-custom 
control written in Java, This program runs as 
a Java application, not an applet. 

This article assumes you are familiar 
with lx>th Java and the Macintosh Toolbox. 
'Hie Java portion of this program was 
developed using the Sun Java Development 
Kit (JDK) version 1.0.2. The native code is 
written in C. CodeWarrior 9 is used to build 
.1 PowerPC shared library from the C code. 

Why Native Code? 

One of Java’s strengths is that it often 
insulates the programmer from the 
specifics of the users’ platform. Sometimes, 
however, you need access to information 
that cannot be retrieved using one of the 
existing Java packages. 


Fortunately, java allows you to call non-Java code, usually 
referred to as native code. Using the Sun JDK v 1.0.2 on the 
Macintosh, this native code must exist as a PowerPC shared library 
if you liave access to one of the non-Java integrated development 
environments, creating such a library is available as a project option. 
Refer to your development environment information for details. This 
article will use Code Warrior to create a shared library. A sample 
CodeWarrior project for this purpose is also included with the JDK, 

Briefly, here are the steps in the overall development process: 

1. Write and compile the Java code that makes the call to a 
native method. If the file is called <native>.java, die generated 
code will be contained in <narive>,class, 

2, Drop the <native>class file onto the Java! I application (induded 
with the JDK), which will generate the header and stub files. 

3- Move the <mtive>.h and <native>.stub files into die folder 
with your native code. 

1 Build the native library in CodeWarrior, using <native>,c as 
die source file. 

5. Move the native library (or an alias to it) to one of two places: 
the JavaSoft Folder in die Extensions folder, or the folder 
containing the java front-end. (These locations are mapped into 
die classpath by Java Runner, so it can find any supporting axle.) 

6. Write and compile the Java code for the front-end, 

7. Drop the .class file containing your application’s mainQ 
method onto the Sun Java Runner application to run it. 

Before we begin, let’s take a closer look at shared libraries 
and what should be put in them. 

What’s in a Shared Library? 

A shared library consists of functions that may be called by 
one or more applications (or other types of axJe, including other 
libraries). The shared library functions do not run as standalone 
code. Rather, the shared library provides its services to 
applications that know how to call its member functions. Shared 
library code exists in a separate file from the code fragment or 
fragments that comprise the application. 


Andrew Downs <andrew.downs®tiihme.edu> is a programmer for the Office of Medical Informatics at the Tulane University 
School of Medicine in New Orleans, LA. He also teaches C and Java programming at Tulane University College. Andrew wrote 
the Macintosh shareware program Net Manager, and ihe Java application UDPing, 
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when creating a PowerPC shared library, the function code 
gets compiled into the data fork of the library file. Tlx* tlata fork 
acts as a container for the compiled code, (Multiple containers 
may exist in the data fork, blit we won! deal with that issue 
here.) A code fragment resource (of type 'cfrg T ) with an ID of 0 
(zero) is placed in the resource fork of the library file. This 
resource contains information about where in the data fork the 
library code begins, as well as what architecture the code 
adheres to (in tills case, PowerPC). 

The shared library must lx: loaded into memory before use. 
this may be done when the client application starts up, or as 
requested by the application. Our Java code relies on the latter 
approach: one of the classes contains a call to load and prepare 
the library at a specific time during program execution. The 
Process Manager (which handles the launching and running of 
applications) relies on the services of rhe Code Fragment 
Manager to prepare the library code for execution. (For more 
information on the Code Fragment Manager, refer to Inside 
Macintosh: PowerPC System Software.) 

You will see that the source code for our shared library does 
not resemble a typical Macintosh application. It has no event 
loop, and does not initialize any of the Toolbox managers. 
Instead, the functions in our shared library rely on ihe diem 
application to set up any managers that may lx* required. 

The current version of the JDK does not contain any packages 
or classes that let you peek at the currently running processes on 
the system. That will be the purpose of our shared library: to obtain 
and provide process information to our Java front-end program. 

Getting die process information into the shared library is 
easy, A function in the sharer! library calls the appropriate 
Process Manager routines, and saves the data they return. 

We need a way to get this process information from the 
shared library to our Java program. We accomplish this using a 
Java class containing definitions of native methods. (The word 
“native* is a modifier in Java which may be used in method 
declarations. It indicates that the body of the method is defined 
elsewhere, and is not Java code.) These native methods am really 
Dills to C functions in the shared library. We will treat them like 
accessor methods: each is responsible for one action, such as 
returning to the caller a specific piece of data. One of them 
instructs the shared library to read a new set of process 
information. Another returns die number of current processes. A 
third returns the partition size of a specific process, and so on. 

Setting up tut Shared Library 

At this point, we know that we have to create a shared 
library containing C code, and that the functions in this library 
will lx- called using native methods in a java class. We 
determined that die functions will return specific pieces of data. 
We can now design the shared library in more detail 

The Process Manager information we need includes the name, 
partition sizc t and current RAM in use by each process. Once w-e 
get the information, we store it in a (global) array of siructs, Each 
struct contains the data for one process. To get at the data, we will 
walk through the array, checking each element in turn. 


We can setup the header file for our C code as fallows: 


Listing 1: ProcessWatcher,h 


ProcttssWatdief.il 

The header file fi>r ProcessWuidier.c. 


Procc'SsWaichcr.h 
M,,m .."7 

// IXline some macros to make our ■code more readable. 

^define Nil 01 

^define ONE KBYTE_3IZE 1024 

//define DIFFERENCE FACTOR 16 

Aden no MAX„NUH RECORDS 20 

^define STRING LENGTH 32 

// I Mini: .i struct that holds the informalimi we want for 
// one process,Then create an array of these * 1 structs. 

struct appStruct 
l 

Str32 proressNatne: 

long processSi^e; 

long currentSize: 

1 : 

struct appStruct gArrayl HAX_HUM_RECORDS ]: 

// One global variable as an array counter. 

short gNumteeards; 

// Our function prototypes. 

long DoGetNuniRecordst void ): 

long DoGetCurrentSize( long 1 ): 

long DoGetProcessSi 2 e( long i ): 

long DoGetProcessNameLengih( long i ) i 

long DoGetProeessNaiHfcChart long i. long j ); 

void DoGoLProcesslnfa( void ): 

'Ihe first five function prototypes listed alxive retrieve array data 
for file caller (in our program, the Java front-end). The last prototype 
corresponds to the function which actually calls the Process Manager. 

Notice that all of the return values are long integers. Tills is 
because of die translation of java primitive data types to 
Macintosh data types, which we will examine shortly. 

Now we can look at the implementation of those functions. 
This is a partial listing of the contents of Process Watcher,c. We 
will view the remainder shortly. 

l isting 2: ProcessWatcher.c 


Process'Watcher,c 

Retrieve and save information about currently running processes, 

HoCSctNumRccunls 


long DoGntNumRecords( void ) 

I 

return( { long )gNumRecords ): 

\ 


DoGeiCurrcntSize 

long DoGetCurrentSize( long i ) 

I 

treturn( gArrayl 1 1,eurrentSize ); 

) 
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DoGetProcessSize 

long DoGetFrocessSize[ long i ) 

( 

return! gAttayf I ].processSize ); 

} 


DoGetProcessNarndjength 

. 

long DoGetProcessNain 0 Length( long i ) 

( 

return( gArrayl i ].processNamef 0 ] ); 


D^rtPrt^essNamKlhar 

long DoGetFroces^KameChart long ± w long j ) 

f 

return! gArrayl 1 ].proeessMame[ j ] ); 

*«* HtttilirnlHii ■«¥« 

DoGetProcessJnfo 

// This routine walks through the current process list 
// and retrieves information we need. 

void DoGetProcassInfaC void ) 

{ 

FSSpec theSpee; 

OSEtr theError; 

ProcesalnfoRec thelnfoRec; 

ProcessSerialNumber thePSN; 

Str32 theMante: 

// Reset the array count. 

gNumRec cards = 0; 

.// Setup the record lor retrieving process info. 

thelnfoRec.processInfoLangth = sizeof( ProcessInfoRec 1: 
thelnfoRec.processName = theName: 
thelnfoRec. pmcessAppSpec - &theSpec; 

tfceFSN.highLongOfPSN = NIL; 

LhcPSN.lowLongQfPSN = kKoProeesa; 

// Retrieve process info until no more processes are found, 
while ( GetNextPtricesa( ithePSN ) — ndEri J 
I 

theError = GetFrocessTltfotraiition! btheFiJN, ^thelnfoRec ] : 

if ( theError [= noErr ] 
break; 

// Save the process data into the global array. Start with the process name 

BlockHove( ( Ptr )thelnfoRec . protesaNEitDe * 

( Ftr }gArrayl jJturiRecofds ]*prosesshame. 

STRING LENGTH }; 

// Partition sizes are 16 bytes off when compared to “AboutThis Macintosh". 

// Current sizes are 15 bytes off when compared nr About This Macintosh". 

// Adjust and store the resulting values so our display matches the system display. 

gArrayl gNuoRecords 1,peoeessSize * 

( thelnfoRec. process Size / ONE_KiJYTE_£ 1£E ) 

- DIFFERRNCE_FACTOR; 
gArrayl gNuroRecords J,currentSize * ( 

( thelnfoRec.processSize J thelnfoRec.processFreeHem ) 

/ 0NE_KBYTE_S1ZE } - DIFFERENCE FACTOR + 1; 


Wc will abstract this portion of the design slightly to allow 
some flexibility. This means that the names of the native methods 
will not match the function names just described, although they 
have a similar purpose. Why is this? To allow us to make minor 
modifications to either piece without affecting the other. For 
instance, we can change the variable names in the C code, and 
the Java class still performs the same as before. 

Let’s take a closer look at the Java class containing the 
native methods. 

Native Methods in a Java Cuss 

To use the shared library, Java requires a class definition that 
b>ih loads the library and calls the native methods within it. It also 
requires method declarations inserted in the calling class file 
matching the prototype for the called function. Notice that these 
declarations contain arguments but no body, ending in a semicolon 
(similar to a function prototype), the keyword native’ tells the 
compiler that the code for these methods will be defined elsewhere. 

Listing 3 shows die Java code for our naLive class 
(NProcessWatcher). The purpose of the static initializer is to 
ensure that the shared library gets loaded when this class gets 
loaded. (For details on the loading process, refer to Inside 
Macintosh: PowerPC System Software, and its discussion of the 
Code Fragment Manager.) 

Listing 3: NProcessWatcher Java 


NProccssWatcbcr. java 

The class that will interface to our shared library. 

public class NFrocessWatcher 

( 

// Tell the VM u> load our shared library. 

static 

( 

System,1oodLibrary("FrocessWatcher Library"): 


// Hat are definitions for several simple native methods. Note dial the data types 
// we specify here may not be the same in the corresponding header file, due to 
if size differences between Java's primitive types and the Macintosh's data types. 
if The stubs file should handle thetranslation of the arguments and return t)Jies 
// torus, 

// This method invokes the Process Manager portion of die shared library, 

private native void nativeGetProcesalnfoO : 

// lire following methods retrieve various pieces of information 
// about the current processes. 

private native int nativcGetNutiElaments!) : 
private native int iiativeCetCurrentSize ( int i ); 
private native int nativeGetProcessSize( int i }; 
private native int nativeGetFroceSSNaineLength( int 1 ): 


gNumRecords++: 

// Bounds checking. 

if ( gNutnftecotds > HAXJUMJUiCQRD S } 
break; 


This is a good start, so now we Lum our attention to the Java 
class that contains the native methods. Remember, these are the 
Java calls to our C code. 


private native char 

nati veGotFrocessNaineChar! int i, int j ); 

// Our class constructor, U calls our native method 
if lhat updates tire Process Manager information, 
public NProcessWatcherfl 
1 

this.nativeGetFrocessTnfo{); 

I 
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// Update the Process Manager information on request 

public void updaLeNowf) 

I 

this .TiativcCetProeessInfo (1 : 
i 


typedef struct ClassNFrocessWateher t 
char pad Ill; f Padding for ANSI C 7 
1 Cl as sNFrec e ssW a t cher i 

HandieTo(NProcessMatcherJ: 


// Accessor methods used by our other Java classes to get process into. By hiding 
// the actual culls to the native methods, we ean change ihe implementation 
// without affecting the classes calling in, 

public int gclKuttElenenisO 

I 

return( this.nativeCetNtiJnEletnents() ): 

I 

public int getCurrentSize( int i } 
t 

return( this.nstlveGetCurrentSize£ i } }; 

I 

public int getProcessSizef int i ) 

i 

return( tM s. nati veGetProc.es s Size ( i ) ): 


public Int got Process NameLetigLh ( int i J 

( 

return ( this .nativeGetProcessNanteLength £. i J ); 

I 

public char getProcessManieChar £ int i, int j ) 
f 

return( thle.nativcGotProceesNainoGharf 1. j ) J: 

1 

J 


With i his class defined, we can now compile it. It does nor 
rely on any other classes, so ii will compile by itself using Lite 
Java Compiler in the JDK. 

We still need a way to tie together this class and our shared 
library. Specifically, we need rwo additional files. One is a second 
header file, containing the prototypes lor the Java calls into the C 
code. The other is a stubs file that can handle the translation of 
arguments and return values between our java and C code. The 
JDK provides a tool that will handle this for us- JavaH. 

The Javall utility generates the header and stub files from 
the class file containing the native methods. After you 
compile NProc ess Watcher java, drop the resulting class file 
(N Process Watch er. class) on the Javall icon. This should 
create N Process Watcher, h and N Process Watcher, stubs in the 
same folder as J aval I. 

Move these two files into the folder containing your 
Code Warrior project before building the library. You should not 
modify these files. However, we must use of the information in 
the header file. If you open NProcessWaleherh, you will see the 
native method declarations, rewritten as C function prototypes. 

Listing 4: NProcessWa(thenh 

NProcc®W;itdKT.li 

'ITie JavaH generated header fik' for our native mcthods.This listing is reform at ted to fit 
the magazine page. 


extern void NProcessWatcher netiveGetProcesalnfo 
(struct HNProcessWatcher *) ; 
cxteri long NProcessWatcher_nat i voGnNumKI entente 
(slrueL HNProcessWatcher *); 
extern long NFr£>ceasWHtehei:_nativeCetCurrentSize 
(struct HNProcessWatcher*. long): 
extern long. NProcessWatcher„nativeGetProces£Size 
(struct HNPracessWatcher*, long); 
extern long NProcessWatcher. nativeGetFrocessNameLength 
(struct HNProcessWatoher* ( long); 
extern y*unicodcV long 

NPrucessWaLcher_iLativeGe tProcessNameChar 
(struct HNProcessWatcher*, long, long): 

#itdef _cplusplus 

J 

//end if 

//end i f f* _Includ«J_NProcessWateher */ 


Copy the six prototypes over to ProcessWarcher.c, and paste 
them near the top, after the includes. Delete the word “extern 11 
at the front of each one. Now we can fill in the bodies for these 
functions. Here is the revised version of Process Watcher, c: 

Listing 2 revisited: Process Watcher, c 


FroccssWatchcr.c 

Retrieve ami save information about currently running processes. 

// Implementation of a native shared library for Mac OS. 

// Adapted from the example provided with the JDK vl ,0 2. 

// OS Headers 

^include ^CodeFragments, h> 

// Javal l generated Header 

//include "NFrocetsWatcber.h" 

// Our library header. 

//inel ude "ProccauVutcher, h" 

// Jlie first fune Lions listed are the calls into our native library Huy match the 
// prod Hypes in the header file IN ProcessWatehcr.h, which we included above. 

// The Java data types (int and char) expected as return types by NPmcess Watcher java 
// map to the long int data type on the Macintosh. We didn’t arbitrarily select this; it 
// wan generated hyJavaH as part of NI Vocess Watcher, h 

// Wc have Junctions calling functions to gel the process data. 

// This allows us to change the underlying implementation if necessary 

void NProcessWatehee nativeGetProcessInfo 

(struct KNProcesnWatcher * self) 


DoGeLProcemsIrila0 ; 
I 


long NProcessWatcher.nativeGetNumEleinents 
(struct HNProcessWatcher* 


I 

return( DoGetNumRncords() ) ; 


I 


self) 


//include <native.h> 

r header for class NProcessWatcher V 
ffifndef Included NProcessWatcher 

//define _T n c 1 u d cd_N P r oc es sWa l c h e r 

#i fdef ._cplusplus 

extern “C" I 
//end If 


long NFrocessWatcher^nativeCetCurrentbize 

(struct HNFroce&sWatcher* self, long i) 

I 

return( DoGetCurrentSize( i ) ): 

J 
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long NFrocessWatcher nativeGetProcessSize 

(struct HNProcessflatcher* self, long i) 

I 

returnt DoGetProccssSlzed 1 } ); 


long NProcessWatcher.nativeGetFrocessNaineLength 

(struct HNProcessWateher*, long i) 


return( DoGetPrncessNameLength( 1 ) ); 


long NPLOcessWatche^natlveGetProcessNacneCliar 

(struct HWProcessWatcher * , long i, long j) 


I 

r " 


return( BoGetProcessKameChar( i, j J ); 


DoGctNumRccoids 

long DoGetNumRecotda( void ) 

I 

return( ( long JgNumRecords ); 

J 


DoGetCurrentSize 

long BoGetCurrentSizuf long \ ] 

( 

1 

r 


return! gArrayf i ].eurrentSize ); 


Do(ictProL^sSi/r’ 


long DoCetFrocessSize( long i 1 
( 

return! gArrayf i 1.proceesSize ); 


DoGctProc cssN amc Length 


7 


long DoGetProcesaNaiaeLetigtft( long i ) 


1 


return! gArrayf i ]»procasaHame[ 0 I ): 


Dt^GctPioccssNajmeC har 

long DoGetProcessNaineChar ( long i, long j ] 

t 

return! gArruy [ ± ] >proccssNamol j j ); 


// Setup liie record for retrieving process Lido. 

thelnfoRec.processTnfoLength - aizeof( ProcessInfoRec ); 
thelnfoRec .processHane “ theNnra; 
theToFoRec^processAppSpec = &theSpec; 

theFSN,highLongOfP5N - NIL; 
thePSN.lowLongOfPSU - kftoProcess; 

// Raricvc process info until no more processes arc found 
while ( GetNextFrocessf ithePSN ) — noErr ) 

I 

thcError = GetProcesfiTnf ormtinn ( kthePSN. tthelnfoRec ); 

if ( theError != no Err ) 
break: 

// Save Ljje process data into the global array. Start will] the process name. 

Bloe.kMovef ( Ptr )thelnfoRec.processHame. 

( Ptr jgArrayf gNumRer.nrds 1 *processNadte* 

STRTNG_LENGTH ); 

// Partition si/es arc 16 bytes ciff when compared to "About...* 

// Current sizes are 15 bytes off when compared to “About.. * 

gAtray[ gNumRecords ].processSize «■ 

£ thelnfoRec,processSize / QNE_KBYTE_SIZE ) 

DIFFERENCE FACTOR; 

gAtrayl gNumRccorda ].currentSize = ( 

( theinfoRec.pruceasSize LhelnfoRee.proce^sFreeMnm ) 

/ ONEJOJYTE_SIZE ) - D1EFERKNCK_FACTOR + 1; 

gNuinRecordst+: 

// Bounds checking. 

if £ gMumRccords > MAX_NIJM_RR HORDE ) 
break: 

) 

1 


Each prototype contains lire class name, followed by an 
underscore, then file name of the native method from the class. 
The parameters include a reference to the calling class, and any 
arguments. The first function is declared as void, and simply calls 
another void function in this c file. The other functions accept 
parameters and return values. We specified Java integers in the 
original method declarations, and we see here dial they were 
adjusted (by JavaH) to Macintosh long inks in die header file to 
correspond to the 32-bil data type. 

These functions call other functions in this file to get process 
data, iliase values are then returned to the caI!er (NPntxcssWatdier), 
One more step is required I before we attempt to make the shared 
library project. Make an alias to the file java Shared Library-, which 
is located in the path System FolderExtensionstJavaSc>f l Folder. Place 
die alias Into the folder containing the shared library project. 


jt**t****t***************** 

IMk-tPnxesslnfo 

nniiTi tiimirnntuliT^ 

// This routine walks through the current process list 
// and retrieves information wr need, 
void DoGetFrocessInfo( void ) 

1 

FSSpec theSpec: 

OSEtr theErrar: 

FrocessIftfaRec thp.Inf oRec: 

ProtOssSori^lNumbcr thePSN; 

Str32 theNamc; 

// Reset the array count. 
gNumRecords * 0; 


The Project Definition 

Figure 1 shows Lhe Code Warrior project definition. 


L£j File Code 
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~ 

^ Mac Libraries 
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0 
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0 

B 
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0 
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2132 
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56 
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IK 
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Figure L The CodeWaniorproject. 
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Here are several of the project preferences settings 
necessary to create the shared library: 


PPG Project: 
File Name: 
Creator: 
Type: 


Process Watcher Library 

java 

si ilb 


PPG PEF: 

Fragment Name: ProeessWateher Library 

Library Folder ID: 0 


Our shared Iferary is ac tually a code fragment. The Preferred 
Executable Format (PEF) dictates the layout of the generated 
fragment, The Fragment Name will be used by the Code 
Fragment Manager to identify and load the fragment. We don’t 
use the Library Folder ID setting: it is for specifying the ID of an 
alias resource, which points to a directory containing other 
libraries that our fragment uses. 

We also do not use the version numbers (also in the PPC PEF 
window), preferring to leave them at 0 (zero)* If you create additional 
versions of the library, and do not maintain backward compatibility, 
you can use version numbers to specify which versions of other 
fragments may call in to (or Ik 1 called by) this fragment. 

There are no Initialization or termination entry points defined 
for tliis project. As indicated in the Code Warrior documentation, 
such functions could be used to setup or utardown the resources 
or memory needed by the fragment. There is no main entry poinL 
for a shared library, and so we do not specify one. 

Figure 2 shows the files used in creating the native library. 
(A copy of the shared library is also .shown.) 



I..:..-:-.. £ fjfe$ = 

-- 

.. -./ -..L'-JI 



Name 


Kind 

Li 

S9 

Jir* Stored i. ibrary 

1 ik 

alias 


ID 

hbstubs-j^xiiTipnn c 

22K 

CodeVarrior text ffte- 


£ 

HPrtseess Vi letter h 

22K 

Jiva Runner document 


5 

MProeessW atcher s tubs 

22K 

Java Runner document 


LJ 

PnjeeijVatchrsr Library 

22K 

ItaliveTesI from Exa. 


D 

Process'Victor .0 

22K 

Cede Varner text file 


i 

PracessWatcher .h 

22K 

Code Varner text file 


m 

Pr 0C«j-Va Icher D 

33K 

CbdeVarrw project 




iifjj fjij-j 

- I- 

ja 


Figure 2. The files used to build the native library. 


These are the contents of the files shown in Figure 2: 

* Java Shared Library: an alias to a file in the JavaSoft folder, 
required during the build. 

* NProcessWatcher.il: header for Process Watcher. Generated by 
JavaR 

* NProccssWatchenstubs: stubs for Process Watcher. Generated 
by JavaR 

* ProcessWatcher.c: the calls to the MacOS Process Manager 

* ProcessWateher.h: constant definitions and function 
prototypes for ProcessWalcherx. 

* ProcessWatcher.Tt: project definition file. 


High Performance 
Imaging and Annotation 
Development Tools 


RasterMaster 6.0 - Familiar API and welLproven technology in use 
world-wide by companies such as British Petroleum, Chase Manhat¬ 
tan, Eastman Kodak, Filenet* Ford, Gannett, Hewlett-Packard, I MSI* 
Lexis, Philips, Polaroid, Stemens-Nixdorf, Trix, Unisys, and Xerox. 

50+ Raster Formats All TIFF. JPEG, Groups, Groups MO DC A 
IOCA. CALS, PNG, PCX. BMP, GIF. PhotoCD, ABIC, Flashpix and mors' 

RasterNote rii annotatron/redlining toolkit - includes all popular features. 
Create Sticky Notes. Freehand Drawing, Lines, Ellipses, Polygons 

NEW ADDITIONS: RasterNote, UNIX, Alpha, Flashpix 

Formal Reading, Saving. Compression, Display, Despeckle 
Rotate, Zoom. Pan, Scroll, Deskew, Anti aliased display. 

Auto aspect ratio, [mage processing, Transparent color 
Improved Twain scanning, Color reduction and promotion 

Platforms Win 95, Win NT, Win 3 1, OS/2. Alpha, Macintosh, UNIX 
Environments: DLL, VBX, OCX/ActiveX, Defphi. VB, PBuilder. VC ++ 

Call 617 630-9495 or sec our Website for FREE* NO RISK EVALUATIONS! 

www.snowbnd.com 

PO Box 520 Newton MA 02159 f sE 617 630-9495 Fax 617 63(M3210 
Email salesmq@snowbncl.com 

■MWBOHMIft 

3SOFT1YAHEL.. 

Imaging Software - Powerful l ast, Reliable 


• libsnibs_examplex; export information for use by CodeWurrior 

For this last file, 1 kept the same name as the original 
included with the JDK, but modified the contents to include 
NProcessWatcher.stubs. 

You can now make tills project by pressing Command-M. which 
will compile and link the code. 'Fhe compiler should place the shared 
library file ^ProoessWatcher Library 11 in the project directory. 

Java class interactions 

We can now turn our attention to the Java poition of our 
program* We have already looked at IMProcessWatcher, which 
contains the native method calls* Figure 3 shows the names of all 
of the Java class and source code files. 


.13' . 

jauii fj[ e s 

Name 

Size 

Kind 


SS 

Global* class 


5K 

Java Runner docu. 


C 

Gletoals.java 



Ccdft'H'arrier IDE 1 


a 

NPrwiHWittW cUif 


W 

Java Ruwwr dMU. 


■ 



9K 

CodoVamor EE 1 


a 

PrefsOiStog .class 


5K 

Java Runner drau. 


L’ 

PrafsbHlog.jata 


14K 

CudtYanrtar 0£ 1 


6 

FV«« strife c Uss 


5fc 

Java Runner ducu. 


a 

Process Vatcher class 


9K 

Java Runner doou 


b 

PracesiVatcher java 


18K 

Code Warrior IDE l 


a 

Updater .class 


5K 

Java Runner doou. 


■ 

Updater .java 


9fc 

CodeYarricr IDE 1 

' 

*rr 







Figure j* The Java source and class files for the front-end. 
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Here is the purpose of each java source code file: 

* GlobaLs; constants used throughout the other classes. 

* NProcessWatcher: calls the native code shared library, 

* PrefsDialog; the preferences dialog. 

* Processing data storage for information about each process. 

* ProcessWatcher the front-end and main window. 

* Updater: the thread which periodically calls N Process Watcher* 

Figure 4 illustrates the interaction between the Java classes 
and the library'. 



Figure 4 * Class file and library interaction , 

These interactions are defined as follows: 

1. The Java fronl-end(ProcessWatcher) creates a Java diread 
(Updater), and starts it running. 

2. Updater creates an instance of die class NProcessWarcher, 
which interfaces with the shared library. NProcessWatcher 
loads the PPG shared library (Process Watcher Library). 

3. NProcessWatcher calls a native function within Process Watcher 
Library, instructing it to retrieve and save the current Prtxess 
Manager information* 

T Updater tells Process Watcher to request and display the 
process information. 

5. Updater goes to sleep. On wake up, return to step 3. 

In addition, Process Watcher calls PrefsDialog when the user 

clicks the Prefs button* If the user updates the settings, the 

changes are signaled back to Process Watcher 


Want to know what products are 
available for MacOS 
development? Check out 
Developer Depot" 
<http:// www.devdepot.com> 


Tin- Java Front-End 

The Java front-end is a window that looks vaguely similar 
to the "About This Macintosh" window under the Apple Menu 
(refer to Figure 5). 



Figure 3- 7 he finished product * 

When launched, the front-end retrieves and displays some 
information about the operating system and architecture. Then it 
creates a thread that calls the native code in the shared library, 
The thread instructs the front-end to update its window, then goes 
to sleep for a user-specified number of seconds. When it receives 
the update message from the thread, the front-end communicates 
with the shared library using the native methods described 
previously. It retrieves a count of the numlxr of processes, then 
the partition size, RAM in use, and name for each process, 'fhe 
front-end then draws RAM usage bars in its window. 

The front-end has three buttons near the Ixjttom: Quit, 
Update, and Prefs. Quit leaves the application* Update performs 
an immediate update of the data displayed in the window, This 
ts the same action taken when the thread informs the window 
to update, but using the button it can be done on demand. 
Clicking the Prefs button displays the preferences dialog. 

For simplicity, the user interface items are placed using 
absolute values (screen coordinates). Note that this may affect 
the look of the front-end if you use it on a non-Macintosh 
platform* (Of course, you would also have to rewrite the shared 
library for die new platform J 

T he preferences dialog is a moveable modal dialog, as 
shown in Figure 6. It contains a text field, a scrollbar, and Cancel 
and OK buttons. The text field shows the sleep setting for die 
thread (in seconds). It is set to non-editable, and its contents are 
highlighted. It geLs updated with new values as the user moves 
die scrollbar. The scrollbar is horizontal Larger values are to the 
right. Clicking Cancel will dismiss the dialog without saving any 
changes the user made to the sleep setting. Clicking OK will save 
the changes, then dismiss the dialog, Settings are kept internally; 
diey are not written out to a preferences file. 
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The scrollbar event-handling is related to the texi field in ihis 
way: when the user clicks in ihe scrollbar or moves the thumb, 
the appropriate event is caught, and the number in the text field 
changes appropriately. Currently, page up and page down events 
are not handled. Scrollbar event handling is accomplished by 
overriding the handledventO method in PrefsDialog. 

The updater thread leads a simple life. Once created, it goes 
through a continuous cycle, it first creates an iastancc of the native 
class* which is responsible for calling the native methods (which 
invoke the C functions). Next, the thread tells its parent (the front- 
end) to update its display. Finally, the thread goes to sleep for the 
user-specified sleep interval* When it wakes up, if the native object 
has l^een destroyed lor some reason, it gets recreated. Otherwise, 
the thread instructs both the native object and the parent object to 
perform their respective update operations. 

Listing 6 contains the code for requesting process information 
from the shared library, and Lhc paintQ method used to display it. 
Here is the method that requests the process information. Notice 
dutt it retrieves file process names one character at a time into a 
character array, then converts that array to a String. 

Listing & ProcessWatcher.java (partial listing) 


PniccssWiucherjava 

The fnmt-end for our Java application. 

public void readProeessInfoO 
I 

// Retrieve: the reference to our native class, maintained by the Updater. 

NProcessWatcher teitipHProeottaWatcher = 
thetlpdaterTh read , doGe tNativeClas s {); 

// If the native class has not been instantiated yet* leave. 

If { tempNProcessWatcher nn u ) 

return: 

U Clear out ihc Vector 

the Process List. removeAl lElejneKt s t); 

// Counters fbr trawling lhc array of processes, 

// and the individual process names 
iiU i - 0* j - 0; 

// Si> we know when we've retrieved all the process elements... 

int max = tempNFrocessWatcher. getMunjElements (); 


// Walk through the process elements one at a time. 

for ( 1=0: i < max: i++ ) 

t 

// Retrieve process siza info from the native class 

int theCurRAM = 

tempNPrDrenstfatcher,getCurrentSize{ i ); 
int tbeFartltlon ~ 

teaipllBeuc^s a Watcher. getProcessSize ( 1 ): 

// How long is the process name? 

int theLength * 

tempNFrocessUatcber.getProcessNam^Length( i ); 

// Well hardctxk a max name size. It must be at least as 
if large as the name size in the C code (52), 
chart] LhcCharArray “ uev chart 32 ]j 

// Get the process name, one character at a time. Note the dual 
// counters used to get the char: 

// i b die current process array dement, and 

// | + I is a diameter in the name (Str32) for that process. 

// Our character army starts its dement numbering at 0, but the Strj2 data 
// type (used in die C code) uses location l) for the length of the string, so 
// we have to adjust the counter j to start one element beyond it, 
for ( j = 0; j < theLength: j++ ) 
theCharArtay[ j ] “ 

tempKProcessWatcher .getProcossNaaiEChar ( i * j + 1 ); 

// Once the char array is filled in, create a Java Siring from it. 

String thrNaincStting “ new Striflg( theCfmrArray ); 

// Create a new instance of the Prooesalnib class, fill in 

// the values, tiien place Ihe reference to the object into the Vector 

Processlnfo tempProceflsTnfo ” now FrocesslnfoO » 
tempProcessTnfo.cetCurRAMf theCurRAM ): 
tajopProeessTnfo. sot Partition! theFartition ): 
rempProecESlnfo. setName ( theNameStrifcg ); 
thcProcesiiList.addEiement{ tempProcessTnfo ); 

// force changes to redraw, 
repaint(): 

J 

Listings 6 through 8 contain the Java code fur the front-end, 
preferences dialog, and updater thread, respectively, Listing 9 
contains definitions for various constants used throughout the 
Java classes. These listings are fairly well structured, and should 
be easy to read. 

Conclusion 

Calling G code from Java requires some preparation, You 
must properly construct a PowerPC shared library and define 
methods widiin your java classes for calling this library. We 
explored the steps necessary to get data from the Process 
Manager to a shared library and then to a Java front-end for 
display, in situations where you need Macintosh Toolbox 
functionality that Java does not inherently provide, a shared 
library can be an effective solution. This approach is supported 
by Sun t so iL makes sense to use it if necessary . 
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by Danny Swarzmau, Stow Lake Software 


Putting Java under PowerPlant 



Building a strategic game 
application with a C++ 
engine and a Java user 
interface 


Preface 

With Mac OS Runtime forJava ™(MRJ) 
(Pronounced ‘niaigeO you can use C++ to 
develop a Macintosh application which 
runs Java code. The Java pan could lx* an 
applet, an application or neither. MRJ is 
delivered as shared libraries, The program 
interface, JManager, is supplied in the MRJ 
SDK. Both are available from Apple's Java 
website <hup://appleJava.apple,com/>. 

With MRJ you create a custom java 
runner. It could be general-purpose or T as 
described here, designed to run a particular 
Java program. There are many reasons why 
you may want to do this. For example, you 
may have some legacy code in C or C++, 
such as an engine which performs some 
abstract task. You want to develop a user 
interface that will easily migrate. You also 
would like to deliver an application that 
will work on a PPC Macintosh, This article 
shows how this can be done. 

TicTacPPC is an application that runs a 
particular Java program, ‘itcTacApp. 
TicTacApp contains a caII to a native function 
which is defined in C++ in TicTacPPC Prom 
the perspective of the Java program, file C++ 
application is virtually the virtual machine. 


The application fulfills this noie with the help of JManager, 

TicTacApp 

The Code Warrior project, TicTacApp.java.lt, creates a java 
bytecode file, TicTacApp.zip, This sets up a Tic Tie Toe game on 
the screen. The user plays X and the program responds O. 

The project has three files; 

• TicTacApp.java which contains main(), 

• TicTacCanvasjuva which handles the user interface, 

• dasscs.zip, the Java libraries. 

Since it contains a main{}function, TicTacApp Ls a Java 
application, Since it refers to a native function, it ran run only when 
lhai native function is defined and available to the Java runner, 

TicTacPPC 

'Hie CodcWarrior project. TicTacPPC Jt creates a Macintosh 
application, TicTacPPC which will run only if MRJ has been 
installed in the system. The folder containing TicTacPPC should 
also contain TcTacApp.zip, 

TicTacPPC.it contains all the usual PowerPlant stuff plus 
MRJ stuff: 

• JMSessionStubsPPC 

• NativeUbSupportPPC 

And the application specific files: 

• CTicTacApplieation.cp — the application object calls 
CJManager.cp lo respond to New command. 

• CFrameWindovvcp — support for Java AWT frames. 

• CJManager.cp — communicates with the virtual machine 
through a | Manager session and implements the native function. 

• CTicTacEngine.cp — the class so smart that it never loses at 
TicTacToe. 

The focus of this article is the work done by CJManager.cp 
and C Frame Window.cp, CJManager.cp opens the file 
TicTaeApp.zip and supports the native function. CJManager.cp is 
specific to this application. 


Danny Swarzman develops software lor fun and games Fun for the users that Ls — he drjes it to earn money as a consultant. 
He also works to improve his game-playing skills at l lie San Francisco Go Club. He has been si led at www.,stowlake.com. Sind 
comments, questions and job offers to dannys® stow la ke.com. 
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C Frame Wmdow.cp is relay service passing events IxHwccn 
FowerPlant and (Manager without regard for their contents, 
CFrameWindow.cp Ls a rudimentary version of a general class to 
support Java frames. 

Figure 1 shows how die various pieces of this hybrid 
application fit together. 



Figure L How the pieces of ibis hybrid application fii together. 


Running Java Pr<x;rams 
S tarting up the session 

The application starts up the virtual machine by opening a 
session with JManager. The session is the structure liirough which 
JManager keeps track of the Runtime Instance, that particular virtual 
machine which will run our collection of threads of Java execution. 

JManager uses a JMSession data structure to keep track of the 
session. Tlie application has no access to the internals of die 
JMSession. It does provide JManager with a set of callback 
functions to handle standard files, stdin, stdout and stderr. The 
application also specifies security options, Lelling JManager how to 
limit what the Java program will be able access in die local system. 

Since TicTacPPC will run only one Java program, TicTacApp, 
we don't worry about security and don't need to suppon 
standard files. All these are set to default values. 


CJVlanager.cp 

CJMsmagcr 

The constructor sete up the JManager session, 

CJKanager :: CJManager ( LCoitunander MnSuperCommander ) 

// Set up a session with 1 Setup a contest for the frames, 

[ 

//This is an upp that will run locally so securin' is not used. 

//To run apps, you might warn to put sensible values here 

static JMSecurityOptions securityOptious - 1 
kJMVersion, eCheckReraoteCode, 
false, I 0 ), 0, false, I 0 I, 0. 
etlnrestrictedAccefis, true k 

// If you warn to implement sumdanJ files you must create functions 
// for suitiT. sUlout. stdin and pul pointers to the functions into this 
//jMSessiontJalJljatks structure 
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CO 
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static JMSessicmCallbacks sessionCallbacks = 

I i&JMVersion. nil* nil. nil }; 

// Create the session 

ThrowIfOSErr_ { iMOpenSession C &sSession, 
&securityOptions T ksessicmGallbacks. 0 ) ): 

// Create ihc context for frames to support the AWT. These will be discussed later 

s Context = CFranieWindow : ; Create Context ( sSession, 
inSuperCommander ); 


Idling to give Java some time 

The application gives the virtual machine time to service its 
threads by calling M Idle, It is recommended that JMIdle be called 
at each cycle of the event loop. PowerPianL provides a 
convenient way to do that by subclassing from LPeriodical and 
overriding its SpendTime method. 

QManager.cp _ 

SptJidTime 

The application calls this at idle time. It gives MRJ a chance to attend to its threads. 

void CJManager SpendTime () 

I 

JMIdle ( sSession. kDefaultJMTime); 

J 


Finding Java Entitles with JRI 

The Java Runtime Interface is the standard for a C++ 
program to access Java entities used with MRJ 1.x. It was 
developed by Netscape to support code that works with their 
Navigator™ product. JRI allows the C++ program to find java 
objects and contains specifications for conversion from Java 
types to C++ types. 

The runtime stack and other data used by the virtual 
machine to keep track of the execution of a thread is the 
thread's environment. Calls to JRI pass an opaque structure 
representing the current environment, Through it. JRI locates 
objects, classes and methods. 


Don’t let your threads get tangled 

Because the execution of the Java function is not immediate, 
tiie C++ program should not depend on the results being valid at 
a particular time. Deadlock will occur if the C++ program waits 
for a variable that is changed by the called Java function. 

Multi-threaded or concurrent programming presents its own 
challanges. In this kind of application, there are extra 
opportunities for chaos, A good strategy would be to keep only 
one thread of C++ execution. Let the virtual machine manage 
multiple threads of Java. Keep the native functions short and fast 


CJManager.cp 

void CJManager :: RunApp () 


Q Manager 


// Open file and call main in class appNamc. 

( 

//Find the file. 

FSSpec fileSpec: 

JRIMethodID method; 

char *filetjRL = "fileD//$APPLICATION/TicTaeApp.zip": 

ThrowlFQ$Err_ ( JWURLToFSS C sSession. 
fileURL. &fileSpec ) ); 

ThrowIfdSErr_ C JMAddToClassPath ( sSession. frtileSpec ) ); 


// Find the class. 

JRIEnv* environment = nil; 

Asserts { environment = JMGatCurrentEnv ( sSession ) ); 

JRIClassin appClass; 

char ‘appName = "TicTacApp*; 

Assert_ ( appGlass = 

JRI_FindClass ( environment► appName ) ); 

// Run main. 1 lie third argument of JRLGetStaticMethodlD 
// specifies ;i signature of a Java function. 

// “ ([Uava/Lang/StrmQ;)V" Specifics a function with 

// a single argument which is an array of references to ob jects 

// of class Java/laiig/String. Et returns type void. 


Assert ( method - JRI_GetStaticMethodID(environment. 

appClass. "taaih**. " ([LJava/lar.g/Strin^;)V" ) ); 
ThrowIfOSErr_ [ JMExecStaticMothodTnContext( sGontext* 
appClass, method, 0, nil) }; 


Calling Java functions from C++ 

Through J Manager calls, the application can v irtually call 
Java functions. First the application uses JRI to locate the function 
and then uses j Manager to invoke the function. 

in RunApp() J Manager is asked to execute the main() 
function of class TicTacApp in file TicTacApp./.ip. Firsi 
JManager calls are used to make the file available to the virtural 
machine. JRI calls locate the class. Finally the JManager call 
JMExecStaticMethodInContext{) starts die prtx:ess. 

JRI specifies an encoding scheme to represent Java function 
signatures as strings, There are macros in JRI.h to construct them. 
Search for JRISig Look at the macro definitions and the 
accompanying comments. You can infer the coding scheme, as is 
done here, or use the macros. 

Actually JMExecStaticMethodlnContextO tells the virtual 
machine to queue a request. TicTacApp s mainQ is not interpreted 
until die virtual machine gets around to it. The virtual machine runs 
when it is given time, that is when the application calk JM!dle(). 


Providing Support for AWT 

When die user does something, such as pressing a the mouse 

button, a chain of program activity starts, I lere’s what happens; 

1. The user does something. The operating system reads the 
hardware and makes die information available for the next 
call to WaitNextEventO. 

2. PowerPhmt passes the event to the appropriate method in a 
class descended from a PowerPianL class. In our ease ii will 
be an event handler in CFrameWindow 

3- CFrameWindow passes the event to JManager. 

4. JManager passes the evenr to the virtual machine which 
interprets the appropriate Java function. 

5. The Java program responds to the event and creates visual 
feedback in a frame. 

6. To provide the drawing environment for the Java frame, 
JManager calls callback functions in CFrameWindow. 

7. The CFrameWindow callback manipulates the real windows 
with the help of PowerPianL 


50 


Putting Java under PowerPiant 


MacTfch * September 1997 









The job of the application, handled by CFrameWindow, is to 
provide the event handler for step 3 and the callback for step 7> 

Frames and windows 

An object of the Java Class Frame is implemented in this 
application as a CFrameWindow object. CFrameWindow descends 
from the PowerPlant class, LWindow. 

JManager passes a reference to a structure, JMFrameRef, to 
identify a frame. Through JManager calls, the application stashes 
a reference to its CFrameWindow inside the JMFrameRef structure. 
CFrameWindow maintains a pointer to finds its JMFrameRef, 

Event handlers 

Most events are passed on to JManager for the Java 
program to handle and respond as described above. For the 
activate and deactivate events, the event handler changes the 
appearance of the window itself because there is no provision 
for a callback to do it, 

CFrameWindow.cp _ 

DoSetUounds 

This is called when the user resizes the window. It changes the bounds of the window 
and of the java frame, 

void CFrameWindow :: DoSetBounds { const Rect iinBounds ) 

E 

JMSetFrameSize f mFratne. kinBounds ): 


DrawSelf 

When this is called, the window is being updated and the port is set up. It calls 
JManager to set up die process of drawing by the Java code. 

void CFrameWindow :: DrawSelf () 

( 

JMFramelJpdate ( mFramp.. GetMac.PortO ■ ^visRgra ): 


Ha ndlcKeyPress 

A key has been pressed when the window is in command, forward the event to Java. 

Boolean CFrameWindow :: NandleKeyPreset const EventRecord 
&.i nKeyFvent} 

[ 

if ( inKeyEvent. Modifiers & ctudKey )[ 

JMFrameKoy ( mFrame, inKeyEvent*message 
kcharCodeMask* inKeyE vent .message >> B, 
inKeyEveiit.modifiers ) ‘ 
return true: 

1 

else 

return false: 


Obey Command 

PowerPiant has detected a menu or key equivalent command when the window is in 
command. Forward the event to the Java program. 

Boolean CFrameWindow ;; Obey Command ( CommandT inComiriand. 

void ‘ioFaram ) 

I 

switch { inCoimand ) 

I 

case cmd_Close : 

JttFraineGoAway ( mFrarae ) ; 
return true: 

1 

return mSuperCoramanderOObeyCoimand ( inCommand. ioFaram ); 

1 


Bar Code Fonts & 
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ClickSelf 

PowcrPlant has detected a click in the active window. Forward the event to the 
java program. 

void CFramoWindow ClickSelf ( const SMouseDowiEvenl 
iinMuuseUown ) 

! 

JMFraroeClick ( raFrarae, 
inMouseDown.whereLocal. 
inMouseDown.ffiacEvent.modifiers ): 


ActivateSelf 

This is called when an activate event is received by the window. The Java frame is 

activated and the window is activated. 

void CFrameWindow ActivateSelf () 

I 

JMFramnActivate ( mFrame, true ): 

LWindow :: ActivateSelf (): 


DeaciivateSelf 

This is called w hen an deactivate event is received by die window,The Java frame is 
deactivated and the window is deactivated. 

void CFrameWindow :: Deactivateself () 

( 

JMFrameActivate ( inFirame, false ): 

LWindow :: DeactivateSelf (); 

) 


Frame callbacks 

JManager calls these to do the actual work for the Java Frame 
object. They are declared static. 
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Fm d Frame Win dow 

Retrieve ibe reference to the C Frame Window object from the diem data field of the 
frame structure 

CFrameWindow 'CFrameWindow :: 

FindFrameVindow { JMFrameRef frame ) 

i 

CFrameWindow 'result ~ nil; 
i£ C frame ) 

if ( JMGetFrameData ( 

frame, {JMClIentData*) ^result ) = noEcr ) 
return result; 
return nil; 


SetupPoitCallbsick 

This frame callback sets the port for drawing.The application can use the return value 
of this function to pass an old port reference that can be later retrieved by 
RestofePortCallbackO as a form of diem data .The value is given back to the application in 
the callback to restore ihc port This application doesn’t need to do this. 

void ’CFrameWindow SetupFortCallback ( JMFrameRef frame 3 

1 

OutOfFocus ( nil J; 

CFrameWindow "window » FindFraitcWitidow { frame ); 
if ( window ) 

window’>FocusDraw C ); 

return nil; 


RcsrorePorK-ill back 

lit is callback is provided so that rhe application can save data, like a port, with the 
setup callback and restore it here,This application doesn’t do that. 

void CFrameWindow :; RestorePottCallback ( 

JHFramnRef /•frame*/, void "/*param*/ ) 

( 

I 


Resize RequcstGi I I back 

This frame callback resizes the window. 

Boolean CFrameWindow ;; ResizeReqtiestCallback 
( JMFrameRef frame* Rect ’desired ) 

I 

CFrameWindow 'pane = Find Frame Window ( frame ); 
if C pane && desired ) 
l 

Rect r " pane->mUserBounds; 

r.bottom w r,top + desired>bottom desired -Hop: 
r.right ** r.left + desl red->righl desired>1eft; 
pane >LWindow s; DoSetBounds ( r ); 
return true; 

1 

return false; 


InvaiRcctCallhack 

This frame callback marks a rectangle as needing to be updated 

void CFrameWindow InvalRectCallback [ JMFrameRef frame, 
const Rect *r ) 

1 

CFrameWindow 'pane 3 FindFrameWindow ( frame ); 
if C pane ) 

pane MnvalfortRccl ( r ); 

I 


Shawl UdeCdtback 

This frame callback shows or hides the window, 

void CFrameWindow ;r ShowHldeCallhack ( JHFrameRef frame. 
Boolean showFraraeRequested J 

I 

CFrameWindow ’pane ~ FindFrameWindow ( frame }; 

WindovPtr window - pane'>GetKacFortf); 
if ( pane ) 

if ( showFraaeRequested ) 

ShowWindow f window ); 
else 

ftideWindov ( window J: 


Set Title Callback 

This frame callback changes die window title. 

void CFrameWindow :: SetTitleCallback { JHFrameRef frame. 
Sir255 title ) 
l 

CFrataeWindow 'pane * FindFramoWlndow l frame ); 
if ( pane ) 

paneOSetDescriptor { title ); 

\ 


GheckUpdatcCaUback 

[f the update region isn 't empty start the update process, 

void CFrameWindow CheckdpdatoCalIback [ JMFrameRef frame } 

I 

CFrameWindow 'pane = FindFrameWindow ( frame ); 
if ( window && !EmptyRgn( 

((WindowPeek) fwindow>GetMacPort{))) ->updateRgn)) 
wlndowMlpdatePort(); 

I 


Creating and destroying frames 

When the virtual machine needs to create a new frame, 
j Manager calls an application callback function to create the 
Macintosh structures needed for the frame. A group of functions 
is identified to [Manager as a context. These functions create and 
destroy frames and provide for exception notification. 

TicTacPPC maintains only one context The callback Junctions 
are declared as static in CFrameWindow. In addition to identifying 
the context callbacks, the application can store data in a field of 
J Manager's context structure, referenced by a JMAWTContextRef, 

In this application, the client data of the JMAWTContextRef 
structure is used to store a reference to the commander object 
which will eventually be the super commander of the 
CFrameWindow objects used for frames. Later, 
RequestFrameCallbackO will use the commander object to create 
a new CFrameWindow, 

CFrameWindow .cp 

GeateCootsxi 

Create a context using our context callbacks. Put rhe reference to the super 
commander into context structure as client data 

JHAWTContextRef CFrameWindow ;: CresteContext ( JKSessiuiiRef 

InSession. 

ICommarider 'inSuperOommander ) 

[ 

static J MAWTConLexiCallbacks context Call backs = 

I 

k JMV e r s i on * // always this constant * 

RequestFrameCallback. 

ReleasnFrameCailback, 

LFn I queMemiTDCal 1 hack, 

nil // No exception handling ■ you may want to add it. 

): 

JMAWTContextRef context; 

ThrovIfOSErr_ ( JMNewAWTContext ( icontext, inScsslon. 

icontextCallbecks, 0)3; 

ThrowIfOSErr_ ( JMSetAWTContextData ( context, 

(JMCLientBota)inSuperCommander ) ); 

TbrovtfO$Err_ ( JHResumeAWTContext ( context ) ); 
return context; 

1 
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RcqucstFratneCal lhae k 

This context callback creates a new CFrame Window for die new frame.This 
implementation ignores all the characteristics requested in the call because it will be 
used only with one particular Java pmgramTo make this function more general, use 
these to set the window parameters. 

OSStatus CFrameWindow :: RequestFrameCallback ( 

JMAWTContextRef context, JMFrameRef newFrame, 

JMFrsiittLKind /* kind *f, LTInt32 /‘‘width 4 /. 

UInt32 /‘height 1 /, Boolean /* resizable */. 

JHFrameCallbacks "callbacks ) 

1 

callbacks>fVersion = kJMVersion; 
callbacks’>fSetupPort - SetupPortCaiiback: 
callbacks->fRestoreFort - RestorePortCallback; 
callbacks >fResizeRequest = ResizeRequesiCaiiback: 
callbacks >flnvalRoct = TnvalRectCallback; 
callbacks ->f£howIiide - ShowRldeCal1 back- 
callbacks >fSetTitle = SetTitleCallbaek; 
callbacks->fChsckttpdate = CheckUpdateCallbuek: 

//The context client data contains a reference to a LComnrandcr obje ct 

JHC1ientlteta data: 

JMGe tAWTConL cxlDbL a ( context, kdata ) ; 

CFcameWindow "window - [CFraraoWEndow*)CreateWindow ( 
kFrameWindowResID. (LCanmmrtder 4 )data ); 

// identify the frame structure with the window, 
wl ndow->mFrame - newFrame: 

//The frame’s client data points to the window. 

JMSeLFraiutData ( newF'ramp* C JMGlientData*) window ); 
window->Show [) : 
return noErr; 


RclcascFramcCall bade 

JManager is done with the frame. Destroy its CFratneWindow object 

OSStatus CFrameWindow :: Rcl easeFratneCallfaack ( 

JMAWTContextRef /* context 4 /, JMFramcRcf oldFrane ) 

{ 

CFrame Window ‘pane = FindFrameWind gw ( oidFrame ); 
delete pane: 
return noF.rrj 

\ 


l In iqueMcnulDC fallback 

This context callback isn't used because the Java npp that we re running doesn’t create 
any menus. This code was copied from Apple sample code. 
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CJManager.cp 

RcgistcrNatiw 

Identify CJ Man a ger: Do OMovcO as the C++ function that handles the Java native call to 
TfcTacGmvas .DoOMovcf). 

void CJManager : : RegisterNative [) 

t 


SIntl6 CRrantetfindov :: tlniquettenuIDCallback ( JMAWTContextRef 
/‘context 4 /. Boolean iaSubmenu ) 

f 

static Slntib tbefirstHierHemi = !: 
static Sint 16 theFirstNortnEtlMetiu - 500: 
if (isSubtnenu ) 

return theFirstHiertfenu-H-; 
return theFirstNornjalMenu++: 


IMPOMI-NTING A NATIVE FUNCTION 

The java class TicTacCanvas contains an Interface for a 
function: 

static native void DoOMove{char[]board); 

The keyword native tells the compiler that the function is 
defined by the local system. In this case, it is defined in the 
application, 

A C++ function will take an Java array representing the 
position on the board when it is O's turn to play. After the native 
function executes, the array will contain the new O move. 

The C++ program must tell JManagcr which function will 
implement the native. To identify the Java funtion, the program 
uses signatures as discussed in the JRI documentation. The 
signature for this function is “DoQMove(EC)V”. 


// Find the class. 

JRIEnv" environment “ nil; 

Assert_ ( environment = JMGetCurrentEnv ( ^Session ) ): 
JRIClassID canvasClass; 

static chat ‘canvasClassName = ^TicTacCanvas"; 

Assert { canvasGless = JRt_FindClass ( environment. 
canva&ClassNatne ) ) ; 

// Create signatures far all the native functions. We have only one function. 

//Uic signatures include the function name.This function 

// passes one argument which is an array of the Java type char. It returns void. 

static char ‘signatures - “DoOKove{ [C)V’*: 

//To support the one native function, there is one C++ function. 

// Pass a pointer to an array with one element. 

static void ‘pcocArray[] “ l DoOMove I; 
JRI_RegisterNatives { environment T canvasCIass, 
^signatures* procArray ): 


TJie implementation of the native function 

The array passed lo JRt_ RegtsterNatives contains pointers to 
functions defined as; 

typedef void {*JRI NativeMethodProc)(JRIEnv 1 env, 
jref elessOrObject, ...): 
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The first parameter identifies the thread of Java execution 
invoking the function. The second is the Java object for which 
the function is called If the function is a class function, the 
second parameter is the class for which the function is defined. 

Succeeding parameters are the parameters in the original Java 
call Each of these is of type jref. the general-purpose JRI type. 

In the case of java function, DoOMovef), there is one 
parameter which is a reference to a java array of java type char. 
The type jchar is defined in JRI to represent Java type char. The 
reference to a Java array is not the same as a pointer. The Java 
specifications say that an array of a primitive type is represented 
as a series of contiguous storage locations. The actual data is 
located somewhere in the stack of die Java ihread. For this 
purpose, DoOMove must call GetScalarArrayElement(). 

Included in Sun's JDK there is a utility, javad to help set up 
prototypes for native functions. Using it is more work than writing 
your own prototype for one function. It wiH be obsolete with the 
next version of Java, 

DoOMovt 

This function supports the Java native function void DoOMove(Char[] ioBoard}; 

Find the pointer to the dm in an array of java char. Call the engine to make the move 
in the C++ array whose elements are jchar. 

void CJManager :; DoQHove ( JRJEnv * env. 
jref /*JavaGbject*/, j ref ioBoard ) 

( 

jchar 'board * (jchar*) emr - >Get Seal a rArrayEl entente ( 
ioBoard ); 

CTicTacEngine :: BesiOPosaible ( board ); 


The Application Class 

CTicTacApplication is an PowerPlant [Application subclass. It 
calls CJManager to start up, to spend idle time and to respond to 
New menu commands. 


CTicTacApplicationxp 


CTicTacApplication 

Register the class PowcrPlanL class which handles Java tfames. Stan up (Manager Start 
rccieving idle events. 


CTicTacApplication :: CTicTacApplication0 
( 

Regist-erClass^CCFrameWindowJ : 

CJManageE atartupASession [ this ); 

StartldlingO : 


Forward idle event to JManager. Overrides T.PerkxIital function. 


SpendTtme 


Building and Debugging The Application 

First install all the MRJ stuff and read the MRJ docs and 
the JRI docs. 

To build TieTacPPC, start with the usual PowerPlant stuff. 

Add MRJ libraries to the project. For PPC they're 
JMSess ion Stubs. PPC and NativeLibSupport. 

Add access paths for die includes in the MRJ SDK. 

Add an access path for the Metrowerks Standard Library 
C includes. 

Set in the C/C++ Language settings "Enums Always Int". 

Tliis line in JRI.h causes a problem: 

void Throw(JRIThrowablelD throwablelD) 

( ititerf ace->ThrowProcPtr {this„ throws bl eTD); \ 

1 commented it out. You may choose a more elegant 
solution, especially if you want your callback to be able to 
throw a Java exception. 

Build the project and start debugging. Debug the application 
in the usual way. If you need to step through the Java app at the 
same time, there is an extra step. Open the .zip file in the 
debugger and set a breakpoint where you want it. Now you can 
debug the application in the usual way. It will stop at your Java 
breakpoint as well as those in the application. 

Conclusions and Future Directions 

MRJ, in conjunction with Cade Warrior and PowerPlant 
provides an excellent environment for developing an application 
with parts in Java and pans in C++. 

There are some pitfalls for developing larger projects. The 
most apparent problem is the delay in the sequence of upgrades 
in the long trek from Mountain View to Cupertino. It gets to 
Washington several months earlier MRJ 2.0 corresponding to 
Sun's SDK 1.1 lags behind other platforms by many months. 
There's the additional lag for a version for 68k Macs. This is 
pioneering stuff and it is reasonable to expect that there be some 
retrofitting between the beginning of development and release 
lime for a product using MRJ. 

If you application permits, it would be best to confine the 
interface between the C++ application and the Java code to 
something very simple, Here we just invoke the mainQ and let the 
Java program take ft from there. Instead of making many prototypes 
and signatures, implement one native and avoid the mess. The bulk 
of the work that you put into a project of this nature will endure. 


vttid CTicTacApplication ; ; SpendTime() 

f 

CJManager :: SpendTine(j; 


MakeNewDocument 

Respond to New. 

LModelObjeci 'CTicTacApplication :: MakeNewDocumentO 

CJManager :: QpenApp {); 

CJManager :: RegisterNativeO: 
return nil; 


Bibliography and References 

The MRJ package is available from Apple’s web site aT 
< http ://apple Java. a p p ie. com/>, 

Documentation on the Java Runtime Interface (JRI) is 
available at <http://homenetscape.com/eng/jri/>. 

Another example of using PowerPlant with MRJ: 
<http://vvww,fullfeed.com/-lorax/powerplant.htrnl>. 

Credits 

Thanks to Victoria Leonard for the artwork. Thanks to Mark 
Terry and Bob Ackerman for reviewing work in progress. BO 
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CHALLENGE 


'S 


by Bob Boonstra, Westford, MA 



Image Locator 

Imagine yourself with a collection satellite images and the 
task of finding a particular item in those images. Rather than look 
for a needle in this image haystack manually, you might call on 
your PowerMac to narrow down the choices tor you. We ll enlist 
the aid of our Programmer's Challenge participants to help you do 
that job quickly. The Challenge this month is to detect the 
presence of a target pattern inside a larger background image. 
Because the background has been detected by an imperfect 
sensor, there is noise present in the background image. Your code 
will need to detect the target in the background despite this noise. 

The prototype for the code you should write is: 

#define topLeft(r) ({(Point *) &(c))[0]) 
void InitTarget( 

Bit Map pattern, f* image to be detected 7 
BitMap mask /* bits ill image that we care about */ 

); 

long r mmiPound V ImageDetect{ 

BitMap background Image. /* find the target image in backymuiidlmage V 
Point 1 oc a tions [ J, r return tuple ft of matching locations here 7 

long maxlocat ions. r max number of locations to return 7 

float noise /* allow this fraction of mismatched bits 7 

); 

void Cleanup (void) : f deallocate any memory allocated by IMTargct 7 

Image location will take place in two steps. First, your 
InitTarget routine will be called with the target pattern that you will 
be looking for. Next, the ImageDetect routine will be called 
multiple times with a different background image and an 
associated notes threshold. ImageDetect should locate all 
occurrences of the raiget in the background, allowing for 
mismatched bits up to the noise threshold, and return the location 
of the pattern matches. Finally, the CleanUp routine will be called 
to allow you to deallocate any memory allocated by InitTarget. 

InitTarget wiU be called with two BitMaps that describe the 
target pattern to be detected. The pattern BitMap identifies bits 
that should be set to 1, and the mask BitMap describes the bits 
dial you care about (Is and Os). Any bits not in the mask are not 
part of the target image, and the corresponding values in the 
background image are to be ignored. InitTarget should process 
the targeL image as desired and allocate memory to remember it. 

ImageDetect will then be called multiple times (5-10 on 
average for each call to InitTarget), You should locate each 
occurrence of the target image in backgroundlmage and return die 
coordinate in the background of topLeft(pattern,bounds) in the 
locations array. The noise parameter describes the fraction of target 
bits where the backgroundlmage is allowed to differ from Lhe target 
and still lie considered a match* Up to noise times the number of 
Is in the mask, rounded down, bits may be mismatched. 


Normally, locations will be large enough to hold all of the matches 
found, but you should not return more than the maxLocations 
matches for which storage lias been allocated. The pattern 
matches may lie returned in any order. If the maxLocations limit 
is exceeded, the choice of which matches to report is yours, 
ImageDetect should return Lhe number of matches found. 

Other information: The bounds rectangle for the pattern and the 
mask will be identical. All bits set in the pattern will also be set in 
the mask (but not the converse). The backgroundlmage will typically 
be the size of a large monitor (e,g,, 1024x768, or 1600x1200). 

This will be a native PowerPC Challenge, using the latest 
Code Warrior environment, fn keeping with tradition, September 
is assembly language month here at the Programmers 
Challenge, Solutions may be coded in PowerPC or 68K assembly 
language, C, C++, or Pascal 

Finally, we should note that die Programmer's Challenge liegan 
its sixth year last month* During that time, the Challenge lias 
changed development environments, moved from 68K to PowerPC, 
and expanded its selection of languages. We appreciate the 
participation of our readers, w ithout which the Challenge would not 
be possible. Happy belated birthday, Programmer’s Challenge, 

Three Months Ago Winner 

The June Challenge was to implement a Turing Machine, a 
finite state machine augmented with an infinite amount of 
external storage. Twenty people submitted enLries, anti 17 of 
those worked correctly* Congratulations to Ernst Munter 
(Kanata, Ontario) for submitting the fastest solution and 
returning to the Challenge winner's circle. 

The key to success in this Challenge was being able to 
quickly find the rule that applied to the current machine state 
and the current input symbol. A variety of techniques were used 
to find the applicable rule. Hashing was u*sed by many of die 
faster entries. Ernst uses either hashing or a simple lookup table, 
depending on memory availability. Others sorted the rules and 
used a binary search. The slower solutions typically used a brute 
force approach of simply searching linearly through the Rile set. 

L used two types of test cases to stress the solutions. The first 
case involved a Turing Machine of approximately 2300 rules that 
sorted an input tape with an alphabet of 30 symbols and tape 
lengths of about 100 symbols. This case required over 113,000 
Turing Machine stare changes. The second test case was a Universal 
Turing Machine. A UTM is an interesting creature. Its input tape lias 
two pails, an encoded version of the rules (program) for another 
Turing Machine, which it is to execute, and the input tape for that 
emulated program* The tape also contains an area where the 
Universal TM maintains the state lor the program being emulated, 
lhe UTM operates by looking up the rule (or program instruction) 
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that applies given the current stare of the machine l>eing emulated* 
remembering that instruction while it moves to die current input for 
die emulated machine, and then executing that instruction, 'line 
Universal Turing Machine 1 used operated on a binary alphabet and 
consisted of 184 rules, operating on an input tape that described a 
simple unary addition machine. This test case required just under 
240,000 state changes to execute. 

4he table below lists for each entry the execution times in 
milliseconds for the sort test case and the Universal Turing 
Machine case, total execution time, code and data sizes, and the 
programming language used. The number in parentheses after 
the entrant’s name is the total number of Challenge points earned 
in all Challenges to date prior to this one. 


Name 

Time! 

Time2 

Total Time 

Code 

Data 

Language 

Rrnst Mumcr (246) 

2K.1 

29.3 

57,6 

920 

8 

C++ 

Russ Webb 

30.9 

330 

612 

1696 

140 

C 

Devon Guew 

m 

356 

793 

976 

28 

C 

Gary Bdth (24) 

39.6 

39-9 

86.9 

592 

32 

c 

Mason Thomas (4) 

47.9 

40.5 

89.1 

740 

8 

c 

Kevin Cutts (57) 

47.4 

439 

89.7 

620 

32 

C++ 

Simon Holmes :i Court 

44.1 

42.3 

900 

744 

32 

C++ 

Juerg Wullschlcger 

48.5 

50.4 

997 

476 

8 

c 

Daniel Harding 

960 

63.0 

159.7 

2612 

406 

C++ 

Zach Thompson 

932 

64.8 

161.3 

1076 

48 

C++ 

Gregory Cooper (54) 

107.8 

84.6 

1927 

668 

40 

c 

Graham Herrick 

137.0 

107.2 

244,8 

820 

16 

c 

Andy fclieck (17) 

3239.0 

158.3 

3397.0 

212 

8 

C++ 

Chailes Higgins (20) 

3238.0 

167.8 

3406.(1 

276 

8 

c 

David Whitney 

4174.0 

272.3 

4449.0 

19800 

2745 

C++ 

lijorn Davidsson (6) 

6565.0 

165.6 

6731.0 

224 

8 

C++ 

Terry Noyes 

6737.0 

198.3 

6936.0 

200 

8 

c 

R.B. 




2736 

99 

c 

S.A. 




840 

448 

c 

W.R. 




1148 

8 

C++ 


TOP 20 CONTESTANTS 

Here are the Top Contestants for the Programmer’s Challenge. 
The numbers below include points awarded over the 24 most 
recent contests, including points earned by this month's entrants. 

Rank Name Points Rank Name Points 


l.Munlcr, Ernst 

196 

11. 

Nicolle, Ludovic 

21 

2. Gregg, Xan 

83 

12, 

Picao, Miguel Cruz 

21 

3. Cooper, Greg 

54 

13. 

Brown, jorg 

20 

4d,engyel t Eric 

40 

14. 

Day, Mark 

20 

5, lioring T Randy 

37 

15. 

Gimdnim, Eric 

20 

6* Lewis, Peter 

32 

16. 

Higgins, Charles 

20 

7,Mallett, Jeff 

30 

17. 

Slezak. Ken 

20 

8. Muiphy, ACC 

30 

18. 

Studer, Thomas 

20 

9. Larsson, Gustav 

27 

19. 

Karsh, Bill 

19 

lO.Antoniewicz, Andy 24 

20. 

Nevard, John 

19 


There are three ways to earn points: (1) scoring in the top > 
of any Challenge, (2) being the first person to find a hug in a 
published winning solution or, (3) l>eing the first person to 
suggest a Challenge that I use. The points you can win are: 

1 st place.20 points 5tli place...2 pomts 

2nd place.10 points finding bug.2 points 

3rd place.7 points suggesting Challenge...2 points 

4rh place..4 points 

Here is Ernst's winning solution: 

Turing.cp ® 1997 Ernst Munrer 


Problem Statement 

Implement the engine for a Turing Machine, a stale machine 
which, at each step, reads a symbol from a tape, consults 
a rule which is a (unction of the current state and the 
symbol.The rule specifies a new state, a symbol to output, 
and the directioQ in which to move the tape, or to lull 


Solution 

I first try to build a lookup table as an Hides into die 
rules arm. But this may require an “unreasonable" 
amount of memory. 

Fusel scan Lhe rules to determine the amount of table 
memory required fora simple lookup index. If this 
appears to be too much. I go to plan B: a hashed Index. 

The hash table uses linear open addressing: when the table 
is built and an index location is needed which is already 
in use we have a collision.To resolve it; I scan linearly 
through the index array until a free location is found. 

The size of the index array is larger than the number of 
rules, so a free location wilt always be found. 


Optimization of hash tabic lookup 
The majority of roles will hash lo unique index addresses. 

Rules which hash to the same value can be seen as a 
sequence of index table entries, with the primary location 
containing the first rule address to be found. 

When the Turing Machine Lx executing, any colliding rule 
that is encountered wilt have its index moved to the 
primary index location, on the assumption that it will be 
used again, and will then be found more quickly 


Assumptions 

A minimum amount of table memory of 8It entries is always 
provided. Rut for larger rule sets, an index table that 
will occupy about 1/2 to 3/4 the amount of memory taken 
by lhe rules array itself may be allocated 

The memory allocated for the simple lookup table will be 
the number_of_states * number,.cOymbols, rounded up to 
a power of 2, but nor more than 8K entries, 
or 2 * number^of^rules, whichever is larger 

1/ the memory required for the simple index would exceed 
those rules, for example if there are a lot of boles 
in the symbul/staie space, the hashed index is used. 

The memory allocated fur the hash index array will 
he the larger of 8K entries or 2 * numlser_of_tides, rounded 
up to the nearest power of 2, 

For example, a rule set of up to 2K rules may result in 
a 32 K, byte index: a rule set of 50,000 rules which occupy 
1M of rules memory may get an index table of 512K bytes. 

include <stdio.h> 
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TCP/IP Scripting Addition The Internet Scripting Solution 


The TCP/IP Scripting Addition allows you to quickly 
develop Internet client/server applications using 
AppleScript® If you want to script with MacTCP lw and 
Open Transport™, here's your solution! 

♦ Supports ScriplEditor, FaceSpan™, and HyperCard'"' 

♦ Build net-wise WebSTAR '"CGI scripts 
and custom web clients 

♦ Sample scripts include FTP, HTTP, 

Telnet, Post Office, E-Mail and more 

♦ Featured on the Apple® Internet Server 

Order now through Developer Depot at 
805-494-9797 or other mail order stores 


w 


Mango Tree Software, Inc. 

Box 1057 * Rrnoldiner, Massachusetts USA 02140 
Fax/ Voice 617-327-Q6G3 
salesemangtfre&cnm * www.mangotree.com 


All trademarks are properties of their respective bidders. 

Contact Mango Tree Software for site licensing and redistribution information. 
Copyright O 1993—7 Mango Tree Software, Inc, 



FTP Parameters 


=L 


Set these paran 
(sending) files i 


Telnet Librf 


FTP Host 


Directory 


User ID 


Password 

g 

Type of file trai 

O MacBinary File 


'W Description: 


Telnet Library y1 .0 

Copyright © 1995 Mango Tree 
All Rights Reserved 


no 

Record Stop Run 


I 

set my_telnet_stream to tel nt 
tell myJel net-stream 

try 

connect(your_host) 
read until text(" 1 oc 


^include <stdlib.h> 
include <string,h> 
flinclude "turing.h" 

const enuja l // constants com rolling min size of index 

EXPANSION - 7. 

HINJJIT5 - n* 

K1K_SIZ1S - 1L«MTN_BITS j; 

typedef const TMRule* TMliulePtr; 

Boolean TuringMachine{ 
const THRuln theRulesU* 
illotig ntiMRuleu, 
ulong * 1 Lbelape * 
ulong tapeLen, 
long rvHeadPos, 

TMMoveProc ReportMove 
) I 

TMRulePtr* index; 

ulong state-Q; 

ulong symbolj 

int direction; 

ulong* tape“theTape+rwHeadPos; 

ulong" tapeEnd=theTape+tapeLen: 

ulong mask; 

TMR u 1 e Ft r r ule=t3ieRu 1 e s; 

//The function contains 2 very similar sections, 

// one section uses ft plain lookup table for an index. 

// the other uses a hash table. 

//Try to construct a collision-free index of rule addresses 
// compute table size 


ulong raaxSUte-riile">GldState: 
ulong mtixSyorrule-HitputSymbol; 
ulong minRyn^rulc >inputSymbol; 
riil«++: 

for (int i-l;i<mntRuleB;i++) l 

if (maxState<rule>oldSt<ite) nax5tate-rule->oldSt&te: 
if (maxSyi3iCrule‘>inpUtSymbol) miLxSytii“rulfi->inputSynibol: 
else 

if (minSym>ru1ft->inputSymbol) minSym^rulc->InputSymbol; 
rule++; 

I 

ulong numSyms=maxSyta - mi nSy m+1 ; 

ulong numStates^maxState- 1 -!: 

ulong nijmInd£x“fnuTiiStates ) 1 (mimSyroc); 

if {(minindex<nimStatee) // overflow 

|j t(mimlndex > MIN SIZE) 

U (mimlndex > EXPANSION^numRules) )) // too large 
goto try_hasb; 

// increase size to the next power of 1 

ulqng d uiuny B 1; 
while (numlndex) [ 
numindex»“l: 
dummy^ 1; 

I 

mini Index-dummy; 

// Altaic the table memory 

index-(TMRulePtt‘)malioc(mimlndex* sixeof(THRulePtr}); 

//Always expect m get the memory, but just in ease ... 
if (index=Q) 
return FALSE; 

//All unused index locations will remain 0 
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memset (index.Q, numlndex’sizeof (THRuiePtr)); 
mask“numlndex’ I; 

// Scan the rules and populate the index array 

rule=theRules: 

for (int iM):i<numRules: i++) { 
ulong addr~ 

mask & (rule * GoldStare'auttSyms+nile*kinptitSymbol); 
index [addr]-rule-F+; 

) 

// Using the tollisionfrcc index Labte: 

// loop until the tape halts or we fail on error 

do ( 

symbol“‘tape; 

ulong ad dr "mask, & (state^numSyuis+symbol); 
ruln^index[add r] ; 

if (rule == 0) //iUcgal symbol, no rule 

break; 

symbol-rule■>outputSymbol: 
state“rule->newState; 
direction^rule-kmoveDirection: 

ReportMove(symbol * state, MoveMr (direction)) x 
“tape"symbol: 

if (direction“**kHa11] ( 

free(index): 
return TRUE: 

} 

tape+*direction: 

) while ( Uape>=theTape) && (tape<tapeEnd)): 
free(index): 
return RAISE; 

try_Jiash: 

// Section Z 

// If we get here, we could not make a simple table 
// and have to go with a hash table, collisions are possible 

// Find table size >= minimum size 
numXndex-MlN. SIZE: 

while (numTndex < EXPANSION*numRules) [ 
numlndex*'2; 
j 

//Allocate the table memory 

index-[TMRulePtr *) ms Hoc (numlndex * slzeof (TMRul ePtr)); 

// Always expect to get the memory but just in case ... 

if (index*«*0) 
return FALSE; 

// AU unused index locations will remain 0 

mom set (index. O.numlndex*sizeof (TMRulePtr)): 

mask-nualndex-I; 

ulong hFactor-1 | (numlndex/numStates); 
long b&elta-l [ (hFactor»l); 

// Scan the rules and populate the index array 

rule'theRuies; 

for (int i“0;i<numRules:i++) ( 
ulong addr- 

mask & (rule >aldState'hFactor+niie-HnputSynibal): 

// if primary location is not empty: find next free location 

while (index[addrj) 

addr a mask & (addr+hDelta); 
index[addr3“rule++j 

1 

// Using the hash index table: 

// Loop until the tape halts or we fail on error. 

//This loop is the same as the loop in the first section 

// except we have to check for possible collisions with each rule., 

do ( 

symbol*-* tape; 

ulong addr^mask & (state > hFactor+symbol): 
rule-index[addr]; 

if [rule *— 0} // illegal symbol, no rule 

break: 

// check if we have the right rule, or a collision 


if ((symbol != rule-MrtputSymbol) 

| (state != rule->oldState)) I 
const TMRule* ruleO-rule; 
ulong addrO"addr; 

do I // resolve the collision 

addr=mask 6 (addr+hDelta); 
rule=index[addr] ; 

if (rule ™ 0) l //could not find rule 
free(index); 
return FALSE: 

) 

] while ((symbol l- rule->inputSymbol) 

|| (state !“ rulo->oldState)5: 

index Laddrl =rule0* // move hst-used rule 

i ndex (add r 0 ] = t u 1 e; // tip In chain 


// now we have the correct rule 

symbol-rule->out put Symbol; 
state-nile->nevState: 
direction-rule *>moveB1rection: 

ReportMove(sytnbol.state,MoveDir (direction)); 

'tape-symbol; 

if (direction“kEalt) l //normal stop 
free(index): 
return TRUE; 

) 

tape+=direction: 

l while £(tape>=theTape) && (tape<tapcEnd)); 

free(index); 
return FALSE; 


Want to subscribe to 
MacTech® Magazine? 
Contact 

<mailto:orders@devdepot.com>, 
call 800-MACDEV-l 
or 805-494-9797, 
or fax 

805-494-9798. 
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A CodeWarrior Java Update 


Tint Free hill is the Engineering 
Manager for the Jam Tools team , with 
technical responsibilities for the compiler, 
tinker and preference panel plugins. He 
also concentrates on developing his 
jxnnty hair style. 

Greg Bolsinga writes Class 
Wrangler, worked on porting the ELI 
javac compiler ,; and enjoys relieving the 
TX heat at the local swimming holes while 
not coding, He is a Scorpio, and bis 
favorite color is purple. 

Clinton Popetz just can 't keep his 
hands out of the Java pot, and has the 
burns to prove it, When not engaged in 
mind-meld tilth his Mac, he is a typical 
slap-happy father of two, and a 
practioner of Kuk Soot Won , a mania! 
art in which he serves as a chew toy for 
evil black hells . 

Scott Kovatch is a software 
engineer who lives in Round Rock, 
Texas with his wife Sandy, and their 
two cats Star and Shadow . He has been 
working on Macintosh applications for 
five years, and is currently working on 
the native Implementations for the 
Metrowerks 1,1 Java virtual machine 
and Metrowerks Java, 

Kevin Buettner is the JIT compiler 
lead. He concentrates on the overall Jff 
architecture, performance enhancements, 
and the PowerPC code generator. 

Laurent Visconti is a "virtual* 
Metrowerks engineer Hiing in Boston. He 
spans the bridge between the Java and 
compiler groups at Metrowerks while 
working on the Java bytecode compiler 
and the Java to native compiler. 


It’s hard to believe, but it was just last year that Java first 
made its appearance on the Mac. Since then, lots has changed. 
lliis month’s interview is with the Metrowerks Java team. Read on 
to learn what’s coming down the pike in CodeWarrior Java.,, 

Dave: What Java related technologies is Metrowerks 
working on these days? 

Tim: CodeWarrior Java has seen a lot of extra attention 

recently, and weVe really put a lot of work into streamlining 
the tools and expanding the Java support within CodeWarrior. 
We are making CodeWarrior work better as a Java 
development environment, and we’re adding new 
functionality in several areas. 

For example, we are working on our ability to compile 
java source directly into machine code, leveraging our 
existing compiler backend technologies to produce quality 
Java to native code for a variety of platforms. Well also 
have a new backend which uses our optimization 
technology to produce highly optimized bytecodes. Our 
Class Wrangler tool is growing by leaps and bounds, giving 
developers a more sophisticated mechanism for exploring 
their class libraries. Constructor for Java will be growing 
into a full Rapid Application Development tool for Java 
and will be fully integrated into the IDE. Lastly, our VM has 
received perhaps the most attention, giving us current JDK 
compatibility and undergoing many, many optimizations 
for speed, both in the core VM and in the JIT. 

Dave: What’s the story with the CodeWarrior Java to 
Native compiler? Will it be compatible with the 
various CW Back-ends? 

LaurentiThe Java front-end will generate the standard 
CodeWarrior FR (Intermediate Representation) dial is used by 
all the CW back-ends. Therefore the java compiler will be 
able to invoke any existing or future CW back-end. Because 
of this architecture developers will be able to generate native 
binaries with no need for a JIT or an interpreter. This 


September 1997 * MacXkch 


A CodeWarrior Java Update 


59 





















architecture also enables die various optimizations 
performed both at the IR level and in the back-ends. This 
will allow ihe generation of binary code from Java sources 
equivalent in quality to code generated from C/C++ sources. 

Dave: And the new Java back-end? 

Laurent:We will implement a new Java back-end that will 
translate JR to Javabytecode. Because of the optimizations 
performed on the IR, this new back-end will allow developers 
to generate better optimized bytecodes, 

Tim: This is the same optimization technology CodeWarrior 

Uses in some of its other compilers, so it’s proven. It will 
make even the interpreted bytecodes run more quickly, even 
without a JIT; with a JIT in place, the code runs that much 
faster. Also, size optimization can make applet class files 
download more quickly. 

Dave: WhaCs new with Class Wrangler? 

Greg; First, Class Wrangler is a program that will allow Mac 
users to create zipfiles and examine zip files, with an 
emphasis on zip archive files for Java, You can view all 
the classes in your archive, and add anti remove classes 
from the archive. As Java programmers already know, it's 
really easy to get class files with file names longer than 
ihe Mae's limit of 31 characters. 

When you drop a class file onto Class Wrangler, it will 
examine the actual class data to determine what the class 
really should be called in the zip archive* Class files keep 
lots of data about themselves in their object code. In the 
Information window, you can see all the methods, all the 
data members, the super class, all the interfaces, the 
source file, and the package of a class. You can copy the 
java code or the java signature to the clipboard, which 
really comes in handy for native method calls, both Java- 
native and native->Java. 

Class Wrangler is also ready for JDK l.Ts JAR files* It will 
read and write compressed JAR files. We will be 
expanding ClassWrangler's JAR capability to handle java 
digital signatures and other security features* Soon well 
also add ihe ability to put any type of hie wirhin the zip 
file's hierarchy. This way users can create an images 
directory for their gifs for JDK 1,1, all within a single JAR 
file. Class Wrangler is a simple utility for Mac Java 
programmers, but it's handy for all java programmers. It 
will be on Windows soon. 

Dave: What class libraries will CodeWarrior support? 


Tim: Java frameworks are moving towards the component 

model, which Is great for RAD, By using a defined 
component API, such as Java Beans, we will be able to 
support a variety of frameworks. The tool need only know 
the component API, It can query the component, and the 
user can put them together in a meaningful fashion. This 
allows our users to choose what framework they want to 
use, and lets us remain agnostic about whose framework 
we support. 

Dave: Constructor for Java has been final or some time 
now. Can you tell me about the next generation RAD 
tools as they relate to Java? 

Clint: The preferred mechanism for RAD in Java is quickly 
becoming Java Beans, Beans provides a simple metadata 
infrastructure for component software, and this makes it 
very attractive to RAD tool designers. In the past, 
developers created their own proprietary scheme for 
managing processes such as reanimation, event hookup, 
component introspection, description, and packaging. 
Beans provides a common API for these pieces, and 
provides it in a framework independent fashion. 
Currently, the Java framework landscape is diverse and 
confusing. Bui by building our Java RAD plans on Beans, 
our work can go forward as the framework wars are 
waged, without fear of obsoletion* 

Dave; What VMs will CodeWarrior support? Appie MRJ? 
Sun JDK VM lor Mac? Microsoft VM? 

Scott: Well, there are a couple of levels of ‘support’. The 
first is bytecode support — our Java compiler generates 
bytecode that will work with any java VM, whether it's on 
Windows, Mac, Unix, or any other platform. Then there is 
run support, which means "What can CodeWarrior tell to 
run your Java code?” This one's pretty broad as well — 
just about any Java-enabled browser, Metrowerks Java, or 
Sun’s applet viewer can be used to run your Java code 
directly from CodeWarrior 

Finally, there is debugging support, which means YM’s that 
our debugger can talk to". Our long term plan is for our 
debugger to support any VM that implements Sun’s debug 
Aid, and right now, that means the Metrowerks VM and 
Apple’s MRJ* Obviously, the more VMs we support, the more 
solid your VM testing can be. We understand how important 
that is. Bottom line, we need to be VM-neutrah but we do 
play better with some VM’s than others. 

Dave: Can you talk about the direction of the CW VM? 
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Scot i: 1 guess the best way to describe the VM's direction is 

that we don't intend the Metrowerks VM to be the 
reference standard for Java on the MacOS — it's up to 
Apple to do that as it moves Java into the 05- but until that 
day happens, well do everything we can to provide 
developers with the best tools for Java development- That 
means making sure that our VM keeps up with 
enhancements defined by Sun, and providing the 
additional tools that come along with those VM 
enhancements. To that end, we've updated the VM T 
compiler, and Metrowerks Java to version 1.1.x, which 
should have shipped in final form by the time you read 
this. (Sun seems to pur out .x versions every oilier week, 
so who knows where well be when this article prints!) 

In addition to the t.l features you would expect, the 1.1 
VM will support a number of APIs that can be used to 
embed the VM into a developer’s application. Apple's 
JManager API is supported, as well as Sun's JNI and 
Microsoft’s COM.Many people have asked us if we're 
going to support JRI (Netscape's native interface API), 
When we wrote the VM for Internet Explorer, there wasn’t 
a need for JRI, so we didn’t implement it But now that 
Sun's JNI is becoming the standard for a native interface 
to the VM. and the fact that JNI support is basically cross 


platform, we decided ihat we will support JNI in the 1.1 
VM, f expect that Apple will move from JRI to JNI as well 
given that JRI is generally going away, so it looks like our 
decision was a good one. 

We've also added some new features to Metrowerks Java 
to make it more useful as a Java development tool — 
things like a basic JAR file maker, being able to print the 
console window, more flexible tool dialogs, and the 
ability to choose which VM you want to work with. As l 
write this, we’re still sorting our what will or won't be 
included, so there may be more than that, but l can say 
these will be there. 

Dave: What are you doing to improve JIT performance? 

Tim: Enhancement of our JIT technology is bringing an 

enormous speed boost to our VM’s performance. We have 
engineers that are dedicated to optimizing our core JIT 
technology, and this is really having tangible effects. Between 
CW11 and CWProl, our benchmark scores doubled. We 
expect this trend to continue, as we add more and more 
optimizations to our JIT, 

Kevin: With respect to the JIT, there are two types of 
optimizations which can be done. The first concerns 


Help Make MacTech Work 


Here at MacTech Magazine, we rely heavily on 
outside writers for most of the material that 
appears in our pages. If readers dkl not 
participate in the magazine, sending us their 
ideas and taking the time to write articles, there 1 
would be no MacTech. MacTech Magazine is 
not a staff of writers sending a constant stream 
of one-way messages outwards; it s a living, 
evolving network of readers conversing with 
one another, educating one another, sharing 
their knowledge, their experience, their interest, 
their trials and tribulations and joys and 
successes in the constantly unfolding story’ of 
programming the Macintosh. MacTech 
Magazine doesn't just happen: it's what the 
community makes it. If we carry reports of 
future trends and technologies, if we teach 


useful methods if we review new books and 
tools, if we provoke thought, provide help, ride 
the wave of current interests and concerns, it is 
only because we reflect the thoughts of our 
readers, who speak through our pages. 

You are invited to involve yourself in 
tills exciting conversation amongst readers. 
No matter who you are, no matter what your 
credentials may be, if you have a tale to tell, 
a trick to share, a technique to teach, we 
want you to consider joining the family of 
those who write for MacTech. 

Don’t just wait for a topic to be covered 
or -a technique explained in MacTech* Take 
responsibility! Write us an article yourself! 

To write for MacTech , just send for our 
Writer's Kit. It’s a Microsoft Word flic 
containing the Styles you need to use, and 


giving lots of helpful advice and information, 
including all the legal stuff. You can let us 
know what you're writing about, or, if you 
want to, you can just wriie the article and 
spring it on us when it's done. [Note: We 
also have a need lor people willing to make 
themselves available to write occasional 
product/lionk reviews.) If we publish your 
article, you'll he paid for it! 

Write to us, the editorial staff, at 
editodal@mactech.com (or one of the odier 
addresses listed on page 2 of the magazine). 
Take die future of MacTech Magazine into 
your ow n hands! 


MxJMi 

U A G Af [ ft t 
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improvements in code quality, i,e, making the JIT compiler 
produce code which is more optimal in some way. The 
second is concerned with making the translator (ITT) itself 
faster or more space efficient, 

Our recent efforts have been towards improving code 
quality, sometimes at the expense of translator speed. As 
Tim mentioned, we’ve seen a tremendous improvement 
in some of our benchmark scores. This is due to an 
optimization step which weVe added which performs 
transformations on the internal representation of a 
method. One example of the type of optimization that 
we’ve done is to look for patterns which represent the 
logical not operator in java. Since there is no java 
bytecode which represents the logical not, a java 
compiler is forced to compile something like the 
following java statement: 

cond = Icond; 

into the following java bytecodes: 

0 iload_0 

1 ifeq 8 

4 iconat_0 

5 goto 9 

8 iconst_l 

9 istore_0 


Note that there are two branch instructions. If we were to 
naively transform this to native code, we’d also end up with 
a test and two branch instructions. But on most processors we 
can do considerably better, What we did is to invent a new 
instruction called "loot". Our optimizer recognizes patterns 
like the above and transforms these patterns to our new 
inot p instruction. Remember that this new instruction is a 
new instruction in our internal form, not some new bytecode 
weVe added. Rul if we were to code it as bytecodes, the 
above would look something like this: 

D iload_0 

1 Inot 

2 istorej) 

Of course there are many other optimizations that we do, 
but most of them are similar to the one described above 
where we look for certain types of patterns and then 
perform the obvious transformation. Our future efforts 
will be to do more of the same and also some tuning of 
the JIT compiler itself so that it will do its translation in a 
shorter amount of time, 


Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto:editorial@mactech.com> 


Dilberf by Scott Adams 



SOME SAY IT 15 HAN'S 
ABILITY TO REASON 
WHICH SEPARATES 
hin FROM nERE 
ANIMALS. 


SURELY YOU REALIZE THAT 
IN THE ANIMAL KINGDOM 
THERE IS NO EQUIVALENT 
TO "ALL-STAR WRESTLING." 




OOH- WE'RE 
MISSING IT 
RIGHT NOW. 


STOMP YOUR 
FOOT TWICE LF 
YOU'RE FOLLOW¬ 
ING ANY Of 
THIS AT ALL. 
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by Nicholas C ll nick.c tf DeMello <online@mactecb.com> 



No coffee jokes* Simply put : it's time to get serious about Java* 
Tiie promise of Java was that Java compiled code would not be 
restricted to a specific type of computer. While a C program mast be 
compiled for a single chipset (Power PC, Mac 68k, Pentium, NeXT, 
etc ), java was intended to be compiled for a virtual machine. Java 
virtual machines (Java interpreters) could be created for all platforms, 
so the program you compile on your Mac could then be copied to 
— and run on — any computer your customer might own. 

That was the theory. But before it could happen Mae OS 
resident Java developers needed a Mac OS virtual machine* We 
also needed Mac OS java compilers, sufficient documentation, 
tutorials and example code to get started* Guess what? The tools 
are online, Java is ready for us and it's time to get to work* 

Starting Points 

Sun has put a wealth of Java documentation online, 
including a description of the history and nature of Java by Jason 
English — definitely worth reading, A good starting point for 
exploring Mac OS Java resources is the Apple Flavored Java 
pages and make sure to check out the ACM Java Pages by Omar 
Patino Sileceo for other valuable links, 

At MacWorld this year Apple announced Macintosh Runtime 
Java 1.0—a Java virtual machine for the Mac* Mac OS 8 will 
incorporate MRj 1,02 (available now on Apple's Java site), and 
Apple is expected to ship MRJ 1.5 (final) one month after Mac OS 
8 is released* MRJ L5 includes a JIT (just in time) component but 
is not fully Java 1,1.1 compliant. Early tests indicate MRJ 1.5 will 
have tremendous performance boost due to its JIT component. 
Webintosifs JVM Showdown has an excellent discussion of what 
JIT is and how it effects JVM performance. 

Sun's lava Documentation 

< http://www, javasoft eom/docs/> 

Apple Flavored Java 

<h itp:// www. m bm design s.corrV maqava/> 

The ACM Java Pages, by Omar Patino Siliceo 

<http://a cm. o rg/ - ops/ja va. h tm I > 

MRJ, Runtime Java for the Mac 

<http;//app I ejava.apple,com/> 

Hie JVM Showdown 

<http://www.webi mash, com/fea tu res/j vm ,htm l> 

Getting Educated 

Mary- Otmptone and Kathy Walrath have authored the 
definitive java Tutorial, an amazingly deep, multi-layered document 
that is really five tutorials in one. Hie five sections offer increasingly 
challenging content: the basics of java programs; writing applets; 
creating a user interface; networking & security issues; and 
integrating native methods into java programs. Another good 
introductory' tutorial is Elliote Rusty Harold’s “Brewing Java 11 site. 


When you get past the basics check out two advanced 
tutorials by Stefan Koch and Nelson Yu. Stefan's "KneeDeep” in 
Java site requires a working knowledge of Java, but will lead you 
through some very kool projects. The AWT tutorial gets into the 
details of how to use the abstract window toolkit to manipulate 
many standard GUI components such as buttons, lists, menus, 
and text areas. It also requires a working knowledge of Java. 

The Java Tutorial by Mary Campione and Kathy Walrath 

<hnp://java,5uncom/docs/books/tutoriai/> 

<http://f ava.es. uni-roagdeburg .de/java/dokus/Tutorialb 

Brewing Java by Elliotte Rusty Harold 

<http ://sunstte.un c, edu/javafaq/java tutor i a I. htm !> 

KneeDeep m Java by Stefan Koch 

<http;//rummelplatz, uni ■ man nhel m .de/- skoch/javatut/kneedeep, h tm> 

Nelson Yu's AWT Tutorial 

<hnp://java cs* on i-magdebu rg, d e/dokus/AWT Tuto riai/AWTTuto rial. htm b 

The Java FAQ at digital focus is host to two essential Java 
references. Click on the "How do L T or java resources” links to 
post and answer Java questions or tour one of the most extensive 
collection of Java links on the web, Usenet’s comp.lang.java 
newsgroup has recently been divided into eight component 
newsgroups, but the comp Jang, java FAQ lives on. It Is regularly 
pasted to comp Jang, java .programmer, and can also be accessed on 
the sunsitc web server. looking for example code? Visit the Java 
Class Warehouse, Geojava Comer, and Gamelin’s Java Tools page. 

The Java Developer FAQ 

<http://www.d igitalfocus. com/d igita Ifocus/f aq/index, htm l> 

Ho do I 

chttp ;//www.d ig italfocus.com/dig rtalf ocus/faq/h owdoi. htm l> 

The comp. I a ng. java newgroups 

<http;//www, javasoft, com/abauU a va/ne wsgrou ps. htm l> 

The comp.langjava FAQ 
chttp ://suns i te. une. edu/java f aq/ja va fa q. htm I > 

The Java Class Warehouse 
<h ttp ://w ww.jia uber. com/java/jcw > 

Geo Java Corner 

< http://www. ggrweb, com/geo j a va/> 

Gamelm's Java Tools Page 

<http://java. developer. com/pages/G amelaa utiLbtm l> 

Parting Shots 

That's it for our tour of Java. Well leave you with a few final 
links to explore on your own. Keep your eye on Marimba, The 
Castanet technology is still rough, but very promising... 

Marimba, home of Castanet Streaming Java, 

Castanet will be included in Mac OS 8 

< http:// www. ma r i mba com/> 

WWDC '97, Internet Technologies Track, Where Apple is going with Java 

<http://devworId,apple,com/dev/WWDC/internettech noiog i es.htmb HO 
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TIPS & 
TIDBITS 


by Sieve Sisak 



Problem 

Your Mac is crashing, and all your disk utilities report no 
problems. Yet you know something is wrong! 

Solution 

Check, and if necessary, repair your System file using 
ResEdit. Here's how. 


1. Start ResEdit, and select Verify... from the File menu. 


File 


New... 36N 

Open... 380 

Open Special ► 

Close 36 ID 

Save 38S 

fleuert File 


Get Info for This File 

Get Flle/Folder Info. 


Derify... 


* 

Page Setup... 

Print... 9GP 


Preferences 


Quit *Q 


2. Open your System Hie: 


Q Sgttein f older 


CDPnntMom tor [lonimrnlv 
Scrapbook FJIe 

Cll Screen Snapz 

OShutdourn Morn* 
CDSturtup tt*m$ 

Q SlurtupScrggn 


LJ Syttem 


□ Use Atlas instead at anginal 


System 

I Ejed "1 

[ Desktop 1 

f Cancel ] 

C jg?~;i 


3. If ResF.dit finds a problem, it will tell you: 


4* Since the file is locked, it cannot be repaired. Make a 
copy of die System file by 

t) Press the Option key 

ii) Click on the System file 

iii) While holding the Option key down, drag the System 
file to the desktop. This will make a copy of the System 
file. 

Repeat steps 1 & 2 above, hut instead of selecting the 
System file in the System folder, select the System file that you 
just copied to the Desktop. 

6. This time, because die file is not use, ResEdit can make 
the repairs. 




Drag the damaged System file from the System folder 
and place ii in the Trash. 

9. Drag the repaired System file from the Desktop to the 
System folder, 


0 

Horning: tuts Mr anpenn to tie daiimytMl. 
Van vfiuultl Cancel and use your Dock up 
copy of this fire. 

| cancel ] 


This tile cannot be repaired because It is 
locked or it resides on □ lacked enigma. 



10. Restart your Mac, All is well. 

Bill Modesitt 
hMnmuisoftware.com 

m 


64 


Tips & Tidbits 


MacTecii • Skptembhr 1997 








































































by Jessica Courtney 


Iconovlx Corf, Introduces EchoSearch Web Software 
for the Mac intosh — The First Truly Intelugent 
Desktop Research Tool 

Iconovex Corporation, makers of the desktop-based, 
professional research tool EchoSearch, announced a Macintosh 
version, EchoSearch 1.08. A simple, yeL powerful tool, EchoSearch 
significantly improves the efficiency and accuracy of Internet or 
corporate Intranet searches. 

Making use of Java's multi-ihrcading capabilities, EchoSearch 
enables users to simultaneously query multiple seaah engines. 
Unlike other Web search tools, EchoSearch features an intelligent 
back-end that can index and accurately summarize the research 
documents that are gathered in response to the query. 

Once the complete hit list has been built. EchoSearch again 
uses java's multi-threading capabilities to simultaneously 
download the documents and to process them linguistically, 
extracting the important phrases and ideas. 

The resulting indexes and summaries are then matched 
against the user's original query and the user is presented with a 
condensed view tliai contains only the most relevant entries. 
These entries are then hypertinked to their occurrences in the 
original documents. After viewing the research results, a user lias 
the option of refining the original search by rcLurniug to the 
EchoSearch interface and clicking on the “Refine Results” button. 
When this alternative is selected, the program then displays 
another subset view of the refined query on the initial global 
views (documenLs/hits that were found the first time). 

EdioSearch for the Macintosh can be downloaded for free 
from the Iconovex Web site at <http://www.iconovex.com>, 

Lasso 2.0 Sins a New Standard for Web Database 
PuBIJSHING ON THE MAC OS 

Blue World Communications, Inc. began shipping lasso 
2.0, an upgrade to Lasso, for Web-cnablcd database publishing 
with FileMaker Pro 3d) for Mac 08, Lasso 2,0 is the only 
complete solution for web-enabling and Java-enabling 
FileMaker Pro, the leading Macintosh database from Claris 
Corporation. Lasso 2,0 is a fully Integrated publishing solution 
that is well suited to any size enterprise. 

Lasso 2,0 Is packed with features that previously required 
scores of separate .solutions costing thousands of dollars. Beyond 
advanced FileMaker Pro Web integration. Lasso 2,0 provides all 
die advanced dynamic Web database publishing capabilities one 
might expect This includes built in image conversion, logging, 
comprehensive conditionals, multi-tier remotely controlled 
security, ability to send Apple Events, complex Server Side 
Include functions and more. Noteworthy is Lasso 2.0's new 
“Inline" command which allows multiple database operations to 


lie processed all within a single HTML file. Also, Lasso 2.0 can 
now operate as an action based upon unique file suffixes and 
reference format tiles stored anywhere across one s local network. 

Unlike competitive solutions, Lasso 2.0 provides full support 
for FileMaker Pro features such as repeating fields and related 
records via portals. What's more, lasso was the first and remains 
the only FileMaker Pm Web enabling solution LhuL contains built- 
in email forwarding capabilities. 

Lasso 2,0 operates on die principle of easily editable HTML files 
which contain all database integral ion commands and dynamic page 
generation instructions alongside standard HTML page elements. 
This extended HTML mark-up ’language" is referred to as the Lasso 
Dynamic Markup language (LDML). The LDML method lias proven 
itself superior to users who quickly outgrow cumbersome and 
limited "wizard-like" approaches to database integration. 

Lasso users operate in their HTML authoring environment of 
choice and use the included O UT based FM Link tool to drag- 
ancl drop LDML commands into their Web pages, providing the 
most direct way to add database functionality while working in 
a graphical HTML editing environment. 

Commerce Capabilities 

LaSvSo 2.0 expands upon Lasso 1.2. Us already rich commerce 
capabilities providing full cookie support and the ability to pass 
tokens along with the ability to send Apple Events to MucAuthorize 
for credit card verification. With Lasso's built-in email forwarding 
capability, one sends customer order receipts immediately via 
email. Sample online shopping cart templates and databases ait 
provided which assist users with rapid cyberstoie development, 

Java-Enabling FileMaker Fro 

Lasso 2.0 allows java applets and applications to access 
FileMaker Pro databases from anywhere on the Internet. Java 
developers use tile provided set of Java classes Eu create dynamic 
front-ends to FileMaker Pro data. Sample applets provided by 
Blue World include a Java-based FileMaker Pro client that mimics 
the FileMaker Pro standard Interface, a Java-based chat forum 
code-named “CoffeeHouse", a Lasso Tags database and a 
database info gathering example. 

Built-in Web Server 

Lasso 2.0 Server version offers a built-in Web server 
optimized for dedicated FileMaker Pro Web database servers. 
Beyond all the capabilities found in the CGI and plug-tn versions, 
Lasso 2.0 Server provides standard Web server features including: 
the ability to serve HTML, GIF, and JPEG files (in addition to 
other MIME types), selectable port controls, suffix mapping, 
process controls based upon suffix name and more. 
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Free Solutions 

To assist users with building dynamic Web database solutions, 
Blue World provides numerous tree templates and databases* 
Solutions include online shopping carts, guestbooks, discussion 
forums, Web calendars, numerous Java examples and more. A listing 
of solutions is available at <http://vwwhtueworld.com/lassa/solutEDns/>* 

Further information about Lasso including links to online 
examples and free run-limited versions is available on the Lasso 
website at < http://w ww* b I u ewor I d * com /1 asso/>. 

StuffIt InstallerMaker 4.1 with Electronic Commerce 
Capabilities now Available from Aladdin Systems, Inc. 

Aladdin’s Installer Gets New Tasks and Flag Alerts for 
Improved Installations 

Aladdin Systems, Inc., developer and publisher of the 
worldwide compression standard StuffIt, today announced StuffIt 
InstailerMaker '11 began shipping* StuffIt InstailerMaker allows 
developers to easily create custom software installers and automatic 
trialware software (a time-locked demo) without any coding. 
InstailerMaker is the only Macintosh installer with automatic 
trialware creation capability. Trialware created with InstailerMaker 
can be purchased by end users with the click of a button. 

Six New Features in InstailerMaker 4.1 

Two new Tasks make InstailerMaker faster and easier to use* 
The "Display Alert" Task allows developers to show alert 
messages to users at any time during installation. The “Launch” 
Task allows developers to create tasks to launch applications, 
open other files, or launch additional installers that are necessary 
to die installation of their software, without having to include 
them in the installer archive* 

“Preserve Success/Fail Status,” and the “Execute When" 
features leL users know when and if their installation 
succeeded. Preserve Success/Fail Status, allows developers to 
preserve rhe flag that indicates whether the last Task and/or 
Find failed when executing tasks, and the Execute When 
condition* Execute When is a new feature that allows Tasks to 
be set to execute under three conditions: Always, If last 
Task/Find succeeded, or If last Task/Find failed. 

The fifth new feature is the ‘FdiL Installer Finder Info." li 
allows developers to set the Shared and File Locked flags for 
the installer, and/or the minimum and preferred memory 
allocation. This feature makes it easier to retain the custom 
settings for the installer* 

The sixth new feature included in InstailerMaker 4.1 is 
added support for calling IMid extensions before and after Alias 
and Rename tasks. 

InstailerMaker 4,1 features time saving enhancements 
including: the capability to use Shrink Wrap 2.0 and Aladdin’s 
upcoming ShrinkWrap 3.0 for creating disk images as parr of the 
build process, a software license display mode during installation, 
a new update architecture that creates software updaters in one 


tenth the rime and up to 60% smaller, support for building 
additional foreign language installers, a faster find, easier 

Internet TCP/IP configuration for ISPs, the ability to display 
banners and play sounds during the installation process, as well 
as valuable user interface enhancements. 

Electronic Commerce Solution 

With InstailerMaker 4.1, developers can convert their 
software into trialware with two simple menu selections; setting 
the purchase price and demo period, and adding graphics. 
InstailerMaker creates a version of trialware with full featured 
electronic commerce, a fast, simple extension of the installation 
creation process which developers are already required to do, 
but without the extensive additional coding necessary on other 
electronic commerce solutions. 

When InstallerMakerls trialware feature is enabled, the user 
is notified every time they run the software of the number of 
days or launches left in their trial period. They are also given the 
opportunity to purchase the product from within the application. 
The purchase may be made in real time via the Internet, modem 
connection, an 800 phone call, by fax, or postal mail. When the 
demo period expires users will not be able to continue using the 
software without a purchase even if they reinstall it* 

Creating Disk Images with ShrinkWrap 

InstailerMaker has rhe capability to use ShrinkWrap to create 
disk images while building an installer. This eliminates a time 
consuming step in the SCM process and results in more reliable 
product builds. With Aladdin’s ShrinkWrap technology 
InstailerMaker can now produce the master disk images for 
d u pi i ca Li t >n a u torna L ica 1I y. 

Software License Dialog With Foreign language Support 

InstailerMaker supports a separate software license dialog 
box during installation. Developers can add copies of their 
software license agreement in multiple languages (Spanish, 
French, German, etc.) to be displayed before installation. The 
end user must accept the terms of the license agreement before 
the installation will proceed. 

Internet Configuration Support 

New documentation and the Internet PrefSaver have been 
added to assist developers, in configuring a Mac OS computer for 
Internet access. PrefSaver helps ensure user account name and 
password information is propagated across common Internet 
software packages such as Netscape Navigator, Eudora Lite, 
Microsoft Internet Explorer, Internet Config and many others 
through Internet Config. 

StuffIt InstailerMaker is distributed electronically through the 
World Wide Web at <http://www.aladdinsys.tom> and on 
CompuServe. InstailerMaker is sold through license agreements 
directly from Aladdin. Current licensees can download a free 
upgrade of the new version* 
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Stalker Software adds Anti-Spamming Features to its 
Mail Server Products 

Stalker Software, Inc. lias just released its latest feature, Anti- 
Spamming, for both the CommuniGate Messaging System and 
the Staliter Internet Mail Server. The new feature is especially 
popular for Internet Service Providers as they suffer the most 
from senders of bulk email (spammers). Not only do Spam 
offenders fill mailboxes that ISPs maintain for their clients, but 
they also abuse ISP mail servers, using them as relays to 
distribute bulk email all over the world. 

Anti-spam features are included into the both Stalker SMTP 
products: the commercial CommuniGate SMTP module, and into 
the freeware Stalker Internet Mail Server (SIMS). 

The first feature allows the server administrator to put the 
network addresses of spammer hosts into the server Black List: 
all connections from those hosts are rejected, and no mail is 
taken from those hosts. There are already several web sites on 
the Internet that maintain a list of offending hosts addresses: 
information from those sites can be used to fill the Black List. 

The .second feature allows die administrator to restrict relaying 
features of SMTP servers, thus making the servers useless for 
spammers. The server administrator can specify the network 
addresses of all “legitimate" clients of that server. Usually, it’s just all 
the addresses on the server LAN, but it can lx* any set of addresses. 

While messages submitted from those "listed n addresses can be 
sent (relayed) to any address on the Internet, and messages received 
from any Internet address can lx sent to any “listed* system, 
messages from “unlisted” addresses are not relayed to other 
“unlisted* addresses. This makes the hast useless for spammers that 
would want to employ ir for relaying their messages all over the Net. 

These new versions of the CommuniGate SMTP and the 
Stalker Internet Mail Server implement the standard mail 
protocols (PCftSMTP,POP,PWD) via AppleTalk, in addition to 
TCP/IP. Now mailers dial support AppleTalk connections, such 
as the Claris Fa nailer, can use both Stalker standard-based servers 
on AppleTalk-only LANs — the feature thar was available only 
with proprietary products such as Claris OfficeMail. 

These latest updates allow Stalker to offer the special 
package of (25-users license with UUCP, POP, SMTP, and PWL) 
modules, regular price $400) for just $189 to all owners of the 
Claris Office servers. 

The Stalker Internet Mail Server can be downloaded from 
<http://www.stalker.com/SlMS>, This product is free, but it is 
backed up with the Stalker technical support staff and has a 
dedicated mailing list. 

To allow all Macintosh mail server administrators to employ 
these new features as soon as possible, a utility to convert 
Apple/Eiidora Mail Server accounts into Stalker Internet Mail 
Server accounts is posted on the Stalker Web site at 
<http://www.stalker.tom/SIMS/Converterhtnnl>. 

The CommuniGate SMTP and other components of the 
COmmuniCatc Integrated Messaging System can be downloaded 
from <http://wwwAtaiker.com/CommuniG3te>, 

Updates to the new version of the CommuniGate SMTP 
module are free. 


ClearWay Technologies Ships FireSite Web Site 
Accelerator 2.1 Optimized for ISDN-based Web Servers 

Boston, MA. ? July 11, 1997 — ClearWay Technologies, Inc. 
today announced an updated version of its FircSite(tm) Web Site 
Accelerator, which contains special optimizations for ISDN-based 
Web servers. When used with ISDN lines running at speeds from 
56Kbps to 128Kbps, FireSite 2.1 can sustain page delivery speeds 
exceeding 500Kbps, and can increase Web site “traffic capacity" 
by 400-800%, FireSite 2.1 also can now operated in conjunction 
with 'Virtual ISDN connections”. Free demos are available from 
<http://wwwxlearwaycom/pages/demoshtrnl>. 

Many ISDN Webmasters are now hosting additional “virtual” 
Web sites, and FireSite 2.1 f with its integrated Virtual Domain 
Manager, provides an excellent solution, FireSite 2,1 Standard 
and Multimedia Edition include the FireSite Virtual Domain 
Manager, the Web's most advanced single-IP Web hosting 
system. Because server load and bandwidth requirements 
increase as more sites are hosted, FireSite ? s speed and capacity 
increases are a perfect companion for Webmasters hosting 
virtual Web sites on ISDN lines. 

The list of all FireSite 2.1 produces and prices is available at 

<http://www.dearvtfay.com/pages/orderpage.htnib. 

Apple Computer Bundles EveryWake’s Tango Enterprise 
and Butler SQL 

Every Ware Development, Inc. reached a software distribution 
agreement with Apple Computer, Inc. The agreement is to bundle 
Tango Enterprise and Butler SQL, Every Ware's intranet rapid 
application development tool and relational database management 
system with the Apple Internet Server Solution, 

Apple Computer, Inc. is focused on providing a complete 
solution to organizations in business, education, or publishing Ural 
want to establish a significant presence on the Web, The Apple 
Internet Server Solution, which is one of three available software 
solutions for Apple's Workgroup Server family, addresses the 
unique demands of the Web server market by combining software 
from industry-leading Internet developers with Apple's powerful 
new Workgroup servers. 

Tango Enterprise is a leading-edge development tool for 
creating dynamic, Web-1 rased applications for die Internet or 
corporate intranets. Tango's visual development environment 
allows Web developers to rapidly develop and deploy 
sophisticated Web applications that are integrated with databases. 
Tango Enterprise will integrate two of the most popular databases 
on the Macintosh: FileMaker Pro from Claris Corp. and Butler 
SQL from Every Ware Development Inc. Tango Enterprise will 
also work with all other ODBC compliant databases including 
Oracle, Informix, SQL Server, Sybase, Access, and DB2 

The Tango product family allows for rapid construction of 
dynamic Web sites. The family consists of Tango Enterprise, 
Tango for Access, Tango for FileMaker, and Tango Merchant. 
The Bolero product family enables Web administrators to 
effective analyze and maintain high volume Web sites. This 
product is presently shipping on the Macintosh. HI 
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CLASSIFIEDS 


PERCEPTIVE SCIENTIFIC 
INSTRUMENTS, INC. 

Macintosh Developers for US & UK 

Perceptive Scientific Instruments, Inc. is a global 
leader in the development and marketing of digital 
imaging systems for genetics applications. The 
company has offices in the United States and the 
United Kingdom. 

We are currently looking for Macintosh Software 
l>evelo|>ers for both our US and UK locations to work 
on our tiexl generation products for the genetics 
market place. Candidates should have 2-5 years of 
Macintosh programming experience in C/C++ with 
strong analytical skills. Experience with object 
oriented programming methodologies will be a plus. 

Please send your resume to H. Baxi, PSU, 2525 S, 
Shore Blvd., League City, TX 77573, USA or fax to 
+ 1 (281) 538-2222 or email to hbaxi@persci.com. 



Visit MacTech Magazine’s Web site! 

http://www.mactech.com 


Telecom mining job opport¬ 
unity for a programmer 
experienced with cross 
platform development in 
C/C++. Ex pe r i ence w ri l mg 
plug-ins for Adobe Acrobat a 
plus. This is an employee 
position with benefits, but 
without the hassles of 
commuting to a regular 
office. Potential candidates 
must be focused and able to 
work independently. Send 
resumes (in PDF format) to 
vga vin@digapp. com. 

Digital Applications. Inc. 

215 Hast Providence Road 
Aldan, PA 19018-4129 

hit p://w\v w ,d iga pp.com 


Live and Work 
in Japan 

individuals will) pro¬ 
gramming and teaching 
skills needed to work in 
Tokyo on a one year 
contract. Please fax or e- 
mail your detailed resume 
to: International 

Education Services fax 
81-.V3498-7113 or e-mail 
to icsinfo@iac.co.jp 

Interviews with qualified 
applicants will be held in 
September and October this 
year in various locations in 
the United States. 


r . ggg&i 

\J\JM. 
C0TP 

Professional software developers 

looking for career opportunities 
should check out our web site. We 
offer nationwide employment assis¬ 
tance, resume help, marketability 
assessment, and never a fee to the 
applicant. 800 231-5920, Fax 800- 
757-9003 eMai 1 das @ scientific.com 

Scientific 
Placement, Inc. 

■T: . 




The Law Office of Bradley M. Snider man 

California Lawyer focusing on Intellectual Property, 
Corporate, Commercial and Contract law, as well as 
Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need help 
establishing or maintaining your business, please give 
me a call or an e-mail. Reasonable fees. 

(310) 553-4054 
Brad@Sniderman.com 


MacTech* Magazine is your 
recruitment vehicle 

When you need to fill important positions at your company, MacTech' 
Magazine is the consistent choice of companies across the country for 
hiring the best qualified Macintosh programmers and developers. Let 
MacTech' Magazine deliver your recruit-mem message to an audience 
of over 27,(XX) qualified computer professionals. 

Call Ruth Subrin at 

805/494-9797 
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by Eric Simenel 


My first Yellow Application 


Oince most of us are in the process of 
exploring the OpenSte/? (Yellow Box) 
framework and its development environment, 
it’s likely that we are going to encounter the 
similar pitfalls. I thought it would he useful to 
describe my first experience at writing 
something more ambitious than a simple 
snippet, so that you could benefit from my 
trials^ To make the most out of this article, 
you'll need to already hate some knowledge 
of Yellow Box. This article is not a tutorial it 's 
more like apurnal .,, 

First, let me give you a little 
background. I’ve been programming for 
the past 17 years (13 on Macintosh) using 
a lot of languages (in order of appearance; 
FORTRAN, 6502 asm, BASIC, COBOL, 
LISP, Pascal and Object Pascal, 68K asm, C 
and C++, PowerPC asm and Java), and a 
lot of environments and Operating 
SysLems (micros, minis and mainframes). 

As far as frameworks go, Fve only 
used a very' little bit of MacApp and more 
of ODF (the Late OpenDoc Development 
Framework), but mainly Fve used the Mae 
Toolbox when developing company and 
personal stuff. The main reason is that I've 
been developing with it for so long that it’s 
just like an old friend; you know what you 
can ask it to do and what you'd better not 

Since l ve been doing Object Oriented 
Programming for the last 6 years, I’ve 
always regretted a little bit that the Mac 
Toolbox doesn't have GO APIs. Of course, 
I could have used a framework but this 
adds an extra layer which you sometimes 
appreciate and sometimes don't. 


Well, with Rhapsody, it’s OOP from the word go, so no 
more excuses. 

At first, the Objeetive-C syntax with all of its Ts and Ts 
looks really different, but Fd say that after a day or two, you don’t 
even think about it anymore. And anyhow, the Developer Release 
or the Premier Release will come with the Objcclive-C mtxlem 
syntax w r hic:h will be more familiar to the C/C++ developer. 

Although a lot of people admire Interface Builder (IB), and it's 
indeed a very nice tool, 1, for one, think Unit the real power comes 
from the Yellow Box framework. When I developed my fust Yellow 
application, 1 spent maybe 5-10% of my time in IB and the rest in 
Project Builder (PB). I must add Lhai if IB didn't exist, we would 
need to spend an incredible amount of lime writing source axle to 
do what it dtxts since this ttx)I is much more than a simple graphic- 
user interface designer tool, but more on that below..* 

While writing my sample code, 1 learned quite a few T things 
which I didn't find explicitly in the documentation, so I thought 
it might be useful to share them, 1 must add that I later found 
some (but not all) of this information in documents which I 
didn't possess at first, and since I Ixdieve (his will be the case for 
most of you, and that, anyway, who reads the entire 
documentation Ixrfore starting coding, it's still useful to have 
those points collected in a useful way, i.e. this article. 

I guess readers of the late develop magazine will remember 
that I collect Comics Books, Comics in short, and my non-trivia! 
sample code Ls die port of an existing Comics Database 
Management Macintosh application to the Yellow Box. There is an 
additional document "The way 1 collect Comics' 1 in die development 
folder, which explains why I designed the user interface the way it 
is. Tilts article deals with the u how” I designed it. 

The development folder containing all the source code, 
interface files, project files, etc. is on the Rhapsody Developer 
Release CD, and will also be on our web site, whose address is 
not known at this date but which I trust you shouldn’t have too 
much difficulty to find* 

This article contains extracts of the source code only when 
relevant, you might find it useful to read the entire source code 
along with this article. 


Eric Simenel is really happy he transferred in Cupertino's DTS from Paris' DTS. Aside from the fan that he 
got a real good welcome from his current colleagues, he's getting much more sun here than there, and, due to his 
constant location here, he has easier access to Comic Books Conventions where he completed many runs**. The 
currenL mark is at 22,000 and counting. 
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What'S in a Nib (NeXT Interface Bolder) File 

Everything which lias been created in the nib while using IB 
(i.e.* every icon which you see in the “Instances” panel), will be 
instantiated when the nib opens. 

That means that when your application launches, its main 
nib is opened, all objects which have an icon in the “Instances” 
panel will lie instantiated, then their ink method will l>e called, 
then the outlet connections you have established with IB will be 
filled with the appropriate value, and then their awakeFromisJib 
method will be called. 

As an example, since my Yellow application deals with one 
unique Comics database object, instead of allocating it in the 
source code somewhere, I just instantiated ii in the nib file. The 
nib file is not just tor graphic user interface elements. 

This is also one of the reasons why you should use 
subprojects with their own nib files* You load these nib files 
with the JoadNibNamed: method (from NSBundle) when needed 
which saves on memory usage and improves performance. 
And speaking of memory,.. 

Memory Problems 

Always when , and only when , you explicitly call the 
alloc class method, or the retain, copy or mutableCopy instance 
methods, you must release or autorelease the object thus 
allocated. All other objects you get through another method, 
you neither release nor autorelease . 

'that means that if you write 

NSAClass Mbj * [[NSAClass alloc] init]: 

then you must also do either [obj release] if the method where 
you allocated it is the only one using it, or [obj autoreleasej if 
the method is returning this object to somebody else. But if 
you write, for example* 

HSFileMana&er "nsfui = [MSFileManager defaul[Manager] : 

NSData Mata * [nsfm contents AtPatb:fileName]; 

then don't write [nsfm release]; nor Idata release): or you'll end 
up in trouble (I did). 

Also, if you write 

N£Strin& *8tr “ [[NSString allocj iaitWIthCStclngitoyCSttlng]i 

then you must write [str release); or [str autoreleasej; depending 
on the usage, bur if you write 

NSStting *str [NSString strin&WithCStrin&:myCString]: 

then don't release str, (in this case it has already been 
autoreleased by the class method stringWithCString:). 

Memory Protection 

Although when you mismanage memory in the Yellow Box, 
it’s not as bad (directly) as on the Mac OS, you may still have some 
surprises. These problems come from releasing an object too many 
times (see above), going outside the range of an NSArruy object* 
and certainly other ways which haven’t bitten me yet. In all those 
cases of memory mismanagement* if you launched your 
application from the launcher/debugger window in PR, you’ll get 


MORE ABOUT MEMORY 

All objects in the Yellow Box are refcounted. The alloc class 
method allocates the object and sets its refcount to t. The 
retain instance method increments the refcount* the release 
instance method decrements the refcount and if it becomes 0, 
deallocates the object. The autorelease instance method places 
the object in an autorelease pool, When the current event 
ends, or in other words, when the control returns to the Main 
Event Loop, all objects in this pool will be sent the release 
message once* and if their refcount becomes 0, they are 
deallocated. The copy instance method will do the same thing 
as the retain method if the object is immutable. If the object is 
mutable, copy will create a new object with the same content 
and a brand new refcount of 1, just as mutableCopy does. 

You should never call the deal loc method yourself. 

Wh oever creates an object or increments its refcount, 
by any of the provided means, is responsible for decrementing 
its refcount by calling release or autorelease . That's the reason 
why autorelease is provided. For example, when you create and 
return an object to your caller, the caller has no idea how you 
created the object; it could be an allocation, but it could also be 
a static or on a stack or whatever. Therefore the caller must not 
release this object, you have to. But your problem is that you 
may no longer have access to this object later when the 
moment comes. What you do, in this case, is to autorelease the 
object before you return it. If the caller wishes to keep it, then 
the caller must do a retain on it, but if the caller doesn't care, 
then the object will be automatically released at the end of the 
current event since nobody retained It. 

explicit error or exception messages* You then fix the problem in 
your source code* build and test again. Afterwards, in some cases* 
although everything looks fine, you'll experience minor (buL 
irritating!) annoyances: PR won’t build anymore (die compiler 
keeps .sending obscure messages)* PB won’t index your projects.) 
anymore* IB wont save your modifications* or PB or IB will quit 
suddenly and then refuse to launch again. 

Depending on the exact symptom, I found the following 
solutions: quit PB and IB* relaunch them* everything's fine (this 
works 50% of the time)* if not* log out, log in again (takes jusi a 
couple of seconds), relaunch them, everything’s One (this works 
45% of Lhe Lime)* if not* power off* then cold start again (this 
works 5% of rite time). In any case, 1 never lost any data. 

On a brighter side, the more I developed with this 
framework* Lhe less I wrote these silly memory mismanagement 
mistakes, meaning that I have less and less trouble with the 
tools themselves. And anyway, those bugs are currently being 
tracked and will be fixed. 

Updating Window' Content 

'lhe updating mechanism is very different from what you are 
used to on Mac OS, By default your window is buffered (as in 
offscreen)* it can also be retained and non-retained, but l mast say I 
was rather surprised by the standard graphic objects reaction to those 
choices, try it and you'll see what 1 mean. It looks like some of these 
objects assume they are living in a buffered window and have their 
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own bit cache management retying on that assumption, and Ettis goes 
awry whenever the window is not buffered AD die standard graphic 
objects call you (as a developer) to lie able to redraw, such as 
draw Red: (for an NSView) or they will ask for some data as in 
willDisplayCe!l:atRow:column: (for NSBrowser) and dien draw. 

So far, so good; it s not really different from the Mac OS 
frameworks we know. The difference comes from the fact that 
you will not lx: called at all most of the time. If your window was 
in the background and comes to the foreground, chances are that 
the update will occur from the offscreen buffer and your redraw 
method won't be called at all (so if yon put in some debugging 
display like I did at first, don’t be surprised if you don’t see it). 

Some Slightly Annoying Surprises 

Although the APIs of NSBrowser and NSTableView are very 
similar, their mechanism is quite different. To use NSTableView, you 
must (among other tilings) implement the numberOtRowsInTableView: 
method and, as its name suggests, you must return the number of 
rows of tlie table. To use NSBrowser, you must (among other tilings) 
implement the numberOfRowsInColumn: method, The difference is 
that numberOfRowslnTableView: is called a zillion times by the 
NSTableView object, whereas numberOfRowsInColumn: is culled only 
once by the NSBrowser object whenever you dick on a cell in a 
column which will make the browser fill a new column to its right. 

So your strategy as a developer must be quite different. In 
a browser, it is the right thing to do the computation of the 
numbers of rows of the column you’re being asked for in 
numberOfRowsInColumn:, whereas, in a table, you’d better do the 
intensive computation only at awakeFromNib (or in it time, 
depending on your situation) time, and then only if the number 
of rows changes, save off this number of rows in a field of your 
controller so that you can just return this value when asked in 
numberOfRowslnTableView:. 

Setting up IB and FB 

The default rules for indenting text in the PR text editor are 
not necessarily what you'd wish they arc. Don’t hesitate to 
modify them in the “Preferences” window till the indentation is 
as you like. You’ll need to set up the “Indentation” panel criteria 
and the “Key bindings” panel criteria. 

if you happen to close a Palette, using the “Close Palette” 
menu item of the “Palettes” menu in IB, this action won’t dose the 
Palettes window, but remove the current selected palette icon from 
tliis window. To reinstall it, use the “Preferences* window of Ilf 

GDB 

Since it is rather unlikely that we wriLe perfect source code 
the first time, it is useful to follow what’s happening in the 
debugger, or at least in the console. That’s where gdb (gnu 
debugger) makes its entrance. 

What happens to me the most, and following the works of 
my colleagues, 1 found that I am not the only one, is that l design 
my interface with IB, write my source code with PR, build and 
test and nothing happens. The stuffI just wrote just does not do 
what it is supposed to. In nearly all these cases, what’s wrong is 
that 1 had forgotten to establish crucial connections with IB (such 


as a delegate or a datasource, or even an action method). Most 
likely you wiD experience the same problem. 

So the first step is a double one: verify your connections again 
with IB and add some tracing code using NSLog (and don’t forget to 
launch your application through the launcher/debugger window of 
FB, instead of launching it from the Workspace; if you do, however, 
you an still see your NSLog messages in the main console window 
which you can display from fire “Texas’ 1 menu of the Workspace). 
The prototype of NSLog is 
(vord)N$Log(format 

and you use it as you would use print!, except that NSLog has 
an extra format which enables the printing of the 

description of an object (very useful). 

If you end up being halted in gdb because of an exception 
or an error, Lhc following useful commands (also accessible from 
die graphic user interface of die launcher/debugger window) will 
help you determine rhe cause of the problem. There are many 
more commands of course, so read the gdb documentation or 
use its help command to find out more. 


Table l Useful commands in gdh 

Command 

Description 

po (object) 
print * (object) 

print* the description of an object 
prints the content of an object 

print * (structure) 

prints the content of a structure 

print expression 

prints lhc evaluated expression 

bt 

prints the stack crawl 

future-break (method) 

sets a breakpoint fur code not loaded yet 

kill 

terminates the process being debugged 

Note: You can also evaluate and call met hex! s from known objects 

such as 


print * [comicsBase titles] or 

print * (NSScroJIer *)[self verticalScroller] 


Last Note 

Before we enter the detail of each class in my first Yellow 
application, 1 must say that I w r as pleasantly surprised by Lhc speed 
of my development. In less than 3 weeks (and that’s my first Yellow 
application, meaning that 1 spent a lot of time in the documentation 
trying to understand how everything works), I reached a level 
(converting data from die Mac OS database, archiving and 
unarchiving data die Yellow Box way, displaying the database 
content tn 4 different ways, and modifying the data in a rather 
complex user interface) which had taken me 2 or 3 months to reach 
iri C++ with the Mac Toolbox on Mac OS (remember, this is a port 
from a Mac OS application which I’ve been using for years). So, 
whenever you hear some guy speaking about Rapid Application 
Development (RAD) regarding the Yellow Box framework, dial’s the 
real untarnished truth, not just some sales talk. 

One last thing before we go, the Yellow Box framework, 
like MacApp, DDF and certainly others, is a Model-View- 
Controller kind of a framework. Very classic these days, very 
powerful, and very helpful for object reuse. When ) talk later 
about a View (he, user interface), I mean it in the Model-Vicw- 
Controller context, so don’t confuse it with an NSView which is a 
specific class of the Yellow Box, 


72 


My FIRST YELLOW AmOTION 


ttfasudepc. 2_j> In MacTech • Septemjiek 1997 









Onward with the Details 

ComicsObj 

This is the Model part of my application. It only deals with 
data, not user interface. 

The CComics class contains mainly an NSMut able Array of 
CRtles objects which contains mainly an NSMutabJeArray of Clssues 
objects. H fhe important methods are initWithCoder: and 
encodeWithCoder: which arc implemented in all 3 classes to allow 
the archiving and unarchiving of the database (look into the source 
code to see their implementation, nothing really difficult), 
sortAnay:with8rand:withSeries:withKind;withState:withSor1:(tn CComics) 
which not only sorts but also extracts die appropriate titles 
depending on the criteria parameters, and which will be called from 
nearly all the controller objects of the user interlace, and various 
accessor methx xis for each class. 

Since the comics database will be accessed from nearly all 
the controller objects, it was expedient to set up a global object 
(of class CComics) named comicsBase declared in ComicsObjT. 
It could also have been an outlet, paired with an accessor, in the 
main controller (see tlie above paragraph about nib files), and 
then accessed from everywhere with fENSApp delegate] 
comicsBase]. This is mainly a style choice from the developer. 

Since the comics database already existed on Mac OS and 1 
was reluctant to reenter all the data (see the “The way I collect 
Comics" document for further explanation), the in it method of 
CComics can cither convert the Mac OS database or load the 
Yellow Box database thus: 

#if realLoad 

fifllf = [NSUnarohiver iinarchlvftObjectWtthFilecfileKarae] ; 

[setf retat n]; 

comicsBase = self: 

#else 

comicsBase - self; 

[self setTitles:[NSKutableArray array]1: 

[self convertFromMacl : 

[self ssvfiinll] : 

#endlf 
return self: 

You’ll note that in the first case, comicsBase must be 
assigned only after the unarchiving (sell is changed), whereas in 
the other, it must be assigned before the call to _convert From Mac 
which uses this global object 

Since this conversion only has to occur once, unless I 
destroy the application or have data corruption, 1 do a special 
build setting realLoad to 0 to convert the database. Afterwards, 
realLoad is set back to I. 

VerifyController (the main controller) 

The Controller ibr the "Verify” window which is a View. 

This is a very basic use of an NSTable View. Just don’t forget, 
in IB, to connect both the dataSource and delegate outlets of the 
NSTabteView object to this controller and implement the 2 
minimum requested methods numberOfRowsInTableView: and 
objectValueForTableColumnjow: and your table will be fine. 

To be able to return appropriate content in 
objectValueForlableColumn :row: , you should also not forget to give 
an identifier to each column in the IB inspector window; this 
identifier may or may not be the same as Lhc column title (your 


choice, in most cases, it's a good idea to give them the same 
name, il makes source code writing easier later), 

Since this is the main controller, it also provides the appropriate 
action methods (to lie connected with the appropriate menu items 
in IR) to deal with the objects from the subprojects (browser, 
calendar and title longevity). Furthermore, as an NSApp delegate 
(don’t forget to establish the connection in IB), it also implements the 
applicationShouldTerminate: action method which, in this case, will 
lead to the saving of the comics database if it lias been modified. 

Each time the user chooses a new choice in the popup 
buttons, the selChanged method is called, which returns a new 
array of the appropriate CTitle objects* saves the new number of 
rows (see the above paragraph about the number of rows in an 
NSTableView), and calls the private method ^update which, by 
calling the noteNumberOfRowsChanged and reioadData, will force 
a redisplay of the table. 

listing 1 Extract from VerifyController m 

(void)SelChanged 

t 

I comicsBase sort Array: array withBrand: brand 
withSeries;series withKind:kind withState;state 
withSort:sortl: 
nbRows = [array count]: 

[nbSelTitles setlnrValne:nbRowp.] : 

[self _update] : 

3 

- (int)numberOfRowsInTableView: (NSTableView MtableView 

I 

return nbRows; 

I 

(id)tableVfew:(NKTableVfaw *)tv 

yb jec tValueForTubloColuiiin: (MSTableCol Ltmn *) LableColumn 

row:(int)row 

I 

CTitle 'thisTitle - [array obiectAtIndex:rowj ; 

NSString 4 identifier - [tableColumn identifier]: 
if {[Identifier lsEqnalToString:§ ,, Abb"l) 
return [thisTitle abb]; 

else if E [identifier IsEqualToSr.rin£:©“Title 1 *]) 
return [thisTitle title]: 
else return [thisTitle listlssues]: 

) 

- (void) update 

S 

[verffyVtew noteNiunberOfRowsCban^ed]: 

[verifyView reloadRala]: 

1 


BrowserController 

The Controller for the “Browser” window which Is a View. 

ibis is a very basic use of an NSBrowser, Just don’t forget, in 
IR, to conned the delegate outlet of the NSBrowser object to this 
controller (the File's owner Icon should l>e of custom class 
BrowserController since this is a subproject) and implement the 2 
minimum requested methods numberOfRows InColumn and 
wfllDisplayCell:atRow:column:, and your browser will i>c fine. Also 
remember to call [[browser window! makeKeyAndOrderFront:niI| : in 
the awakeFromlMib method or else you won’t see any window and 
lose some lime understanding why. 

Since the browser is defined in a subproject of the application 
project, we have to load its nib file, when the user wants to see 
this window. The menu item he will use is connected to the 

■ (void)riewflrowser: (id)sender [ [ [BrowsetCotHroller allocl 
initl; I 


action method in the Verify Controller which is the main 
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controller The ink method of BrowserControlIer will do the nib 
loading (among other things): 


Listing 2 Extract from BrowserControlIer. m 

- (id)init I 

if (self = [super initj) 
t 

// the browser lies m a subproject, so krs get its nib 
if (IlNSBundle loadNibNamed:@"Hrowser" 
owner:self]) 
l 

NSLog(§"Unable to load Browser.nib"); 

[self release]; 
return till; 

I 

array - [[NSMutableArray alloc] 
initWithCapacity:1500] ; 

I 

return self: 

1 

- (int)browser:{NSBrowser *)sender 
numberOfKowslnColunin: (int) column 

( 

short brand, series, state, kind: 

// the first 4 cohunntns have all only 5 ceils 

if [column < 4) return 3: 

// if not let's see what the user has currently selected in the first odums 

brand = [sender selectedRawlnColuamiQ]; 

series " [sender selectedRowlnColumn:1]: 

state “ [sender seIectedRowInColunm:2] ; 

kind - [sender selectedRowlnColumn:3j: 

// so chat we can retrieve the appropriate titles (we don't care for 
// sorting in this browser) 

[comiesfiase sortArray:array withErandsbrand 
withSeties:series withKind:kind withSLate:stale 
withSort:0j ; 
return [array count]: 


(void)browser:(NSBrowscr *)sender 
villDisplayCell;(id)cell atRow:(int)row 
column:(int)column 
( 

switch(column) 

t 

case 0: switch(row) 

I 

case 0: [cell setSttingValue:@"All Brands"]: break: 
case 1: [ceil setStringValue:@"Karvel~]: break: 
case 2: [cell setStringValue^DC & Others**]: 
break: 

I break: 

case I: switch(row) 

[ 

case 0: [cell setStringValuevirAll Scries"]: break: 
case 1: [cell setStringValue:@"Long"3 ; break: 
case 2: [cell setStringValue:e"Hini w j: break: 

I break; 

case 2 : switch(row) 
i 

case 0: [cell setStringValue:@"All States"]; break: 
case 1: [cell setStringValue:@ M Dead"]: break: 
case 2: [cell setStringValueie^Live"]; break: 

J break: 

case 3: switch(row) 

\ 

case 0: [cell setStringValue:£"All Kinds"!; break; 
case 1: [cell set£LringValue:@"Ma]n"]; break; 
case 2: [cell setStringValue:@"Dual"]; break; 

\ break: 

case 4: [cell setStringValue: 

[[array objectAtlndex:row] title]]; 
break; 

I 

// the 5Ui column is the last 

[cell setleaf:[column =4)]; 

// this means tills cell is ready for display 
[cell setLoaded: YES] ; 


TitlcUingevtiy Controller and TltleLongevityView 

The Controller for the "Title Longevity” window which is a 
View, and the custom view inheriting from NSView which 
implements the graph. 

This is a very basic use of an NSView (MSCustomView in IB). 
The TirieLongevityView is just a graph, and the controller 
allows the user to change the criteria of the graph (through die 
popup menu buttons). TltleLongevityView has to implement 
just 2 methods (initWithFrame: and drawRect:) to work fine. Each 
time a criteria changes, the display (of TitlelongevilyView, 
inheriting from NSView) method is called, which will, at some 
point, calls the drawRect: method. 


Never call drawRect: YOURSELF 

Before drawRect: can be called, the graphic context has to be 
set right (the Mac OS Toolbox equivalent would be a SetPort). That's 
what the Window Server does, and what you should never try to 
attempt yourself. If you want drawRect: to be called, call display 
instead, and the Window Server will do the right thing for you. 

Tlie only thing you have to pay attention to is the fact that, 
the origin is in the lower left comer of the view (this is Display 
Postscript), insLead of the upper left as you might be used to in 
QuickDraw, To draw, you can mix C-ified Postscript calls such as 
PSmoveto, PSIineto, PSstroke and framework calls such as 
dra w A tPoi n t: with A ttri butes: (of NS St r i ng), 

Listing 3 Extract from TilleLongevifyCon troiler. m 

(void)brand5elect:(id)sender 

{ 

[titleLongevity seLflrand:[sender IndexOfSelectedltem]]; 
[titleLongevity display]; 

[nbSelTitles setlntValue:[titieLongevity nbSclTilles] 1: 

J 

(void)serienSelect;(id)sender 

! 

[titleLongevity seiSerics:(sender IndexOfSelettedltem] ]; 
[titleLongevity display]; 

[nbSelTltles setlntValue:ItitleLongevity nbSelTities]]: 

I 

Listing 3 bis Extract from Title inngemty View. m 

- (void)drawRect: (NSRect)reci 

l 

NSStritig *theString: 

abort i, j. startEditMonth, lastEditMonth, tlari [600]; 

// get the right array of lilies 

[comicsBase sortArray:array withBrand:brand 
withSeries:series withKind:1 withState:Q withSort:0]: 
nbSelTitles = [array count]: 
startEditHonth = [comicsBase startEdiLMom:h]: 
lastEditMonth ■= [comlcsBase lastEditMonth]; 

// dear anti then fill the local array to be graphed 
forfi-0: i<(lastEditMonth-StartEditMonth): i++) 
tlarr[i] = 0: 

for(i-0; KnbSelTitles; 1++) 

( 

CTitle 'thislitle " [array objectAiindex:i]: 
NSMtableArray *theselssues = [thisTltle Issues] : 

// if edited then add 1 if there is an issue for this particular edit month 

if fteditOrLong) 

for(J=0: j < [thisTltle nblssues]; j++) 

tlart[[[theselssues objectAtlndex:]] editMonth] 
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startEditMonihJ 1; 

// eisc add I for all months between ihc first published issue to the latest 

else 

for(j “ [[theselsaues objectAtlndex:0] edit,Month ]; 
j <= (ftheselssuen lastObject] edI tM onth]: j 4 ^} 
tlarr f j-startEdiiMotiih] +* 1; 

I 

// draw the axes 

PSsetrgbcolarEG. 0. 0): 

FSido veto (orx t ory-3); FSlineto (orx, 700); PSstrokeO: 
PSmoveto(orX'3, ory); PSlineto[700, ory) ; PSstrokeC); 

// put the labels on vertical axis 
for(i=10; K-130; fcHiO) 
l 

PSmoveLo(orx 3, ory+i*S); 

FSlineto(/GO. ory+1‘5): 

PSstroke (); 

theStriftg - [USStritog etrin&WithCStr in&igmsrnfr [ill; 
[theString dtavAtPoint iNSMakeFoint (orx - 20 , 
ory-UH^) wl rhArrr f hut os :d let ionary] ; 

I 

// put the labels on horizontal axis 

for(i=0; i<(l£istEditMonth-EtartEdItMonth + l3) : i++) 
it {((i + startEditMonth^1) % 12) 0) 

f 

j = (i + startEditMonth-1) / 12; 

PSmoveto(orxii, cry): 

PSlitictn(or*+1, ary 3 {(j % 2)?7:0)): PSsuokeO; 
theStrlng “ [NSSlring EitringWithCString;gnmns [j] ] ; 
|theString drawAtPoint:N$MakePoint(orx+i-9. 
ory-21 - {(j % 2)77:0)) withAttributes:dictionary]; 

I 

// draw the graph in blue 

PSsjetrgbcolor(0, 0* 32767); 

for(i=0: KOastEditMooth starLEdilMonth); i++) 
t 

PSmoveto(orx+i* ory): 

FSlineto(orx+i t ory+tlarr[iJ *5); 

PSstroke(): 

I 


CalendarControIler and CaiendarView 

The Controller for the "Calendar” window which is a View, 
and the custom view inheriting from NSView which implements 
the tabulated display. 

This is another very basic use of an NS View. The 
CalendarView is just some text displayed like a table, and tile 
controller allows, again, the user to change the criteria of the 
display. There is no big difference from the TitleLongevityView 
except for one trick. At first, 1 filled the MSString object to tx 
displayed with the entire text data (with carnage returns), and 
had only a single draw At Point: with Attributes: calk The result was 
that die lines were reversed from bottom to top (which makes 
sense when you remember that the origin is in the lower left 
corner and that the y axis is directed towards the top), .Although 
1 could have reversed the text in the NSString object, it made 
more sense (for easy code reading purposes) to display the text 
one line aL a time, correctly anchored where it should be. 


Listing 4 Extract from Calendar View m 

- (void)drovRect:(NSRcet)reel 
t 

char SLrtit[] = 

" OCT .NOV EEC 97 FEB MAE APR MAY JUN V 

OCT NOV DEC 97 FEB MAR APR MAY JUN \ 

OCT MOV DEC 97 FEE MAR APR MAY JUN W\ 
£trlin[20Q]. etcatart [7] ; 
short i, j, k, n, laeuitmnth. iaharr [1B9] [9]; 

U get the right array of titles 

[conicsBase siortArray: array vithBrand;brand 
withSeries;series withKind:kind withState:2 


withSort;sortl; 
nbSelTitles * [array count]; 
fastmonih [comicsBase latJtEdltMunth]; 

// fill the correct month names or year value in strrit based upon 
// the model above 

for(1=1; i<=3; i++) for(J“l: j<“9: J++) 
strnepy(&strtit[6 + (il)*45 + (j-1)*4l + 

(k = (lastmontXl-9+j) It 12) ? gmonths[k] ; 
grnimsf(lastmonth■1’9+j) / 12], 3); 

// and draw it 

[ [NSString siringWiLhCString; % trtit] 
drawAtPoint iNSMakel’oint (0. reel .size.height j 20) 
withAttributes:dictionary!; 

// dear and (ill the local array of issue numbers to he displayed 

for{i-0: 1<189; iIF) 

for E j=0; j<9 : J++) lnharr[i][j] - 1: 

for (1-0: \ <ribSclTitles: 1++) 

t 

.. , some code irrelevant to the purpose of this 
article, see the source code for details 

) 

if and display it 

for(1=0: K63: I++) 
i 

sLrcpy (suTiii, '**) ; 

For{j=i: j < tibSelTitles; j += 63) 

strepy(strstart. 

f[ [array objectAtlndex:j] abb] cString]}; 
while (sttlen(fltretart) i 6) 
strcat(strstart, M “); 
slrcai(sLrlin. sLrsLart): 
for(k=0; k<9; k++} 
streat(streat(strlin, 

((n “ isharrlj][k1) < G3? w 
(char *) gmims[n]) T “ M ); 
streat(strlin, H M ): 

} 

[[NSString sLringWithCString:strlin] 
dr awAt Point:NSMakeFoint(0.rect.size,height -11 *(i+3)) 
withAttributes:dictionary]; 


InpulControUer 

After getting familiar with the framework by doing .some 
basic stuff (what you read above), 1 eventually reached the level 
where 1 wanted to do more ambitious and serious stuff. This 
Controller (for the "Input" window View) enables the user to 
modify the Comics Database in a lot of ways. 

First, 1 started with an NSTableView, then implemented the 
wiflDispiayCell:forTab!eColumn:row: method which allowed me to 
control the graphical aspect (such as fonts and colors, 
including background colors) of a cell, before 
objectValueForTableColumnirow: is called. 

Then 1 implemented the setObjectValue;forTableColumn:row: 
method which allows the user to type in text data in the first 2 
columns (the only ones which have been set up as editable in IB), 


Listing 5 Extract from inputController.ni 

(int)numberOfRows!nTab1cVicw:(NSTableView *)1ableView 
I 

return nbRovs; 


- (void)tableView:(NSTableView *)tv 
wi llDisplayGail:(id)cell 

forTableColumn:(NSTableColumn *)tableColumn 
row:(lnt)row 

1 

NSSLriug ‘identifier - [tableColumn identifier]; 
[cell setFont;([identifier cString][ 0 ] 

— 'M*) ? fontNonProp : fontProp]; 
if {[identifier isEquaIToString:@"CurTsh ,, l) 

[cell setFont: fotitNonProp]; 
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if {[identifier isEqvialToString:@"Empty"]) 
if (row “ [tv selectedRowJJ 

[cell setBackgroundColor;[HSColor redColor]3; 
else 

[cell setBackfiroufidColor: [HSColor bladtColor ] ] ; 
else If ({row = [tv editedRow]) 

&& C Ltv columnWithldentlfieri identifier] 

“ [tV editedColimn])) 

[cell eetBackgrouEtdCelor: (NSColor whiteColor] ] i 
else 

[cell setBackgroundColor:arrCol[row X 6]J; 

[cell setDcawsBackground:YES]; 

I 

(id)tableView;(NSTableView *)tv 
cbjectValueForTableColumn: 

(NSTableColumn *)tableColumn row:(int)row 

t 

CIssue 'tbislssue; 

CTitle ‘thisTitle “ [array objectAtlndex:row]: 
NSStting ‘identifier 

* jtableColumn identifier], * result; 
thisTssue s [[thisTitle issues] 
objectAtIndex;[thiaTitle 

findlssue:curlsbArray[row3]]: 
if [[identifier isEqualToString: Q* Abb"]> 
result -* [thisTitle abb]; 
else If [[identifier isEqualToString:P"Title w ]} 
result » [thisTitle title]; 
else If C [identifier isEqua!ToString:@“Brand"]} 
result w [thisTitle brand]; 
else if {[identifier fsEqualTDString:@ w Series w ]) 
result = [thisTitle series]; 
else if {[identifier isEqualToString:@"State H ]) 
result = [thisTitle tstate]; 
else If C [identifier isEqualToString:8*Kj.nd"]) 
result ” [thisTitle kind]; 
else if ([identifier isEqualToString:@ w CurlEh“J) 
result “ [NSString 

SttingWithCString; gaums [cur JebArray [ row] ] ]; 
else if ([identifier islqualToStting;@ w Grade 1 ')) 
result = [thislssue grade]; 
else If ([identifier isEqualToSti:ingi@*Type*] J 
result " [thislssue ishtype]: 
else if ([identifier isEqualToSt ring: ^"Content"* ]) 
result “ [thislssue content]; 
else // col umri identifiers "M1 * to *M6‘ 

l 

short k, j * -I, 

1 - theEditMnntb * 6 

+ [identifier cString][l] - '0*; 
for(k - [thisTitle nblssues]-!: 

(k >~ 0) U (j — lh k-) 

if [ [[thislssue = [[thisTitle issues] 
objectAtlndexikJ editHonth] = i) 
ik 1( [thislssue issueFlags] & mskHiss] ) 

i - 

if Cj — -I) result - 
else 

result = [NSString strIngWithCString:gnume 
[[thislssue issueNumber]]]; 

1 

return result; 

I 


At this point, 1 had a scrolling tabic with rows of different 
background colors, and cells with text set up in different fonts, 
and we could edit textualiy the first 2 columns. 

For the other columns, it made more sense to have popup 
buttons to allow the user to edit the criteria by choosing rather 
than by typing. So 1 implemented a doClick: action method 
which 1 connected with IB (this name, doClick, is purely mine, 
we can call this method any name we want, the important thing 
is that it must be connected as a target/action method in IB for 
the NSTableView). In this method, I set up (see the next section) 


the popup button depending on the row and column of the 
clicked cell, with both the InputController and PopupInTable 
classes containing outlets (puit and ic respectively) pointing at 
each other (connected with [B as usual). Since this popup 
button is “kinda 1 ’ floating above the NSTableView, extra care has 
to be applied to have a good user experience. For instance, it 
disappears when you click elsewhere: doClick calls releasePub 
before it sets up a new one, jjpdate (called when the display 
criteria changed) also calls releasePub. 

But that’s not enough... If ihe popup button is displayed 
and the user scrolls the table, then the image of the popup 
button scrolls along, but it really still stays where it was, 
meaning that we get a "phantom 41 undesirable popup button. 
To have the popup button disappearing when the user scrolls 
is a little bit more complex. First, in awakeFromNib, 1 parsed 
the superview hierarchy to get the NSScrollView. The 
documentation stares that there is one, but nothing is said 
about other superviews, and as a matter of fact, between the 
NSTableView and dm NSScrollView. there is an NSClipView; 
since it is undocumented, 1 can’t rely on the fact that the 
NSScrollView is 2 levels up in the hierarchy since it could 
change in the future, hence the little loop: 

for ( aView = InputView; 

E (aViev isKindOfClass: [NSScrollView city]] ; 
aView ” [aViev superview] 

h 

When 1 had the NSScrollView, I saved the current action 
method and target outlet of its verticalScrnllcr, and I replaced them 
with the userHasScrotied: action method and self (respectively). 

Then in userHasScrolledi, just call releasePub and sendAction: 
to the previously saved action and target of the vcrticalScroller 
(or else, our NSTableView wouldn't scroll anymore...). 

listing 6 Extract from InputController.h 

^interface InpuiController : NSGbject 
t 

NSScroller ‘rayVerticalScroller; 
id saveYerticslScrollerTarget.: 

SEL saveVerticalScrollerAction; 

I 

listing 6 bis Extract from InputController. m 

- (void)awakeFromNib 
l 

NSViev T aViev; 

// finding the NSScrollView superview,.. 

for {aView ~ inputView: 

1[aView isKindQfClass:[NSScrollView class]]; 
aView = [aView superview]}; 
rnyVerticalSctoller 

= [(NSScrollView *JaView vertiealScroIIer]; 

II saving the current target and action of the vertical scroller 
// to be able to call them later in userl lasScrolkd 

saveVerticalScrollerTargrt 

~ [nyVerticalScrollet target]; 
saveVertiealScrollerAction 

= [myVerticaiScroller action]; 

// set the new target and action Much more elegant than patching, 

// much more efficient than subclassing. 

[myVerticalSeroller setTargetI self]; 

[myVerticalSc roller 

setAction;^selector(userHaaScrolled:)1 ; 

1 
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- (void)userHasScrolled:(id)sender 
I 

// if the user his scrolled then release the pop up button 

[pult. releascPub] ; 

// and rail hack the original target aird action of the vertical scroller 
// so iliar wc actually scroll . (see bdow) 

[my Vertical Sc roller 
sendAction: saveVerticaiScrollerActitm 
to;saveVerticalScrollerTarget] : 

I 


The number of lines of code to achieve this interception 
mechanism is much less than iLs explanation, and the 
target/action mechanism is the real power of the Yellow Box 
framework. With this mechanism, we can add new behaviors 
without having to subclass (and in this particular case, the 
subclassing would not have been trivial nor easy ). 

PopupinTable 

This is the Controller for die “floating” popup menu button. 

The setUpPopup method creates the appropriate menu 
items according to the row and column of the clicked cell, 
memorizing in a separate array the command and attribute for 

Disclaimer 

This specific usage of a floating popup menu button as I'm 
using it, is strictly my own user interface, As it goes, some of my 
colleagues don't like it since they feel it doesn't respect all the proper 
user interface guidelines. Do not take this sample code as a model 
for your own user interface in your projects. 


each menu item (easier than trying to extract the information 
later from the title of the selected menu item). Since I wanted 
some empty separation menu items in the popup, I discovered 
that you can't add Lhe same title twice (only one will remain), 
so that’s why I use addltemWithTitle:@”“ and then 
addltemWithTitle:®” “ and then addltemWithTitle:®" u , etc. 

The pubSelect: action method modifies the comics database 
according to the choice selected by the user The only twist is 
that, when the user selects the “Other...” menu item, ihe cell is 
made editable and the editColumn: row:wrttiEvent: select: method (of 
NSTableView} is called; then the user has to type in the text data 
which is then analyzed in the setObjectValue:forTableColumn:row: 
method (of Input Controller). 

To prevent endless testing of an empty issues array of the 
CTitle object (in nearly all of the other controllers or CComics 
and Clide objects), we forbid the user from deleting the last 
issue of any title, suggesting deletion of the title itself instead. Fur 
the same reason, when the user creates a new T title, it comes with 
a first issue automatically. 

Since the source code for both setUpPopup and pubSelect; is 
way too long for me to insert in these pages, 1 invite you, instead, 
to take a look at it directly. 


For speed optimization, since a reloadData method call to the 
NSTableView would lx: cosily (there are a lot of rows and columns 
all with different fonts and background colors in our 
NSTableView), and since the deselection of a currently edited row 
forces ilie redisplay of that row calling objectValue- 
ForTableColumn:row: for each cell of this row, I call, where 
appropriate, the sequence deselectRow:/selectRow:byExtending- 
Selection: to always have a valid display of the edited row. 

Conclusion 

You’ll find out, using the Yellow Box framework, that you 
don’t have to subclass as much as you would using a C++ 
framework. The dynamic binding, corning from Objecrive-C, 
enahles us to rely more on the concepts of target/aclion, 
delegation and notification. This dynamic binding has its 
advantages and its drawbacks: you can inspect objects at 
runtime to determine their abilities, thus use objects that you 
never knew about as long as they respond to the appropriate 
messages, reuse objects much more easily, etc. On the 
downside, you can't have as much strong Lype checking at 
compilation time than you would get with C++, which may 
lead to interesting experiences at debugging time. 

As far as notifications go, the Yellow Box mechanism is very 
simple to use. Whenever the content of the database changes, 
the ImputController object will send a notification this way: 

[[NSNotificationCenter defaultCenterl 

postNotification^ame; ComicsDidChange object; self 

Any other Controller (Verify, Calendar, Browser, 
TitleLongevityX wishing to Ixj informed has just to register for 
this notification, in its inii method, for example: 

[ [NSNotiticationCenter defaultCenterl 
addObserver: self selector; ^selector(comicsChanged;) 
name: Com!csDidCharge 
object* nil 

then its comicsC hanged: method will t>e called to do whatever 
appropriate to change the display of the window, whenever 
the InputController sends the notification, ’[‘he only thing to 
remember is to unrcgixler ihis notification in the Controller’s 
dealloc method or else the Notification manager will Lry to 
send a notification to a released object. 

What could be more simple? 

Thanks to out technical reviewers Michelle Wyner, 
Deborah Grits\ Andy Bacbarsky, Andy Belk, Alex Dasher ; 
Tony Frey* and Randy Nelson. El 
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by Erik Sea 


Preferential Treatment under Apple Location Manager 


Apple location Ma nager (AIM) is a 
suite of system software enhancements that 
shipped in January ; 1997* hut unless you*re a 
PawerBook user, you may not have seen AIM 
in action. Later this year, hoimer, you II see a 
completely new version that works on any 
Mac OS 8 computer, be it large or small\ 
battery-powered or tethered to the electrical 
grid. With increased availability, it’s become 
et>en more practical to add AIM sam iness to 
those senses, Ux&s, and applications that 
need it, and over the next fetv pages we’ll 
discuss some ways to do just that . 


At the heart of MM is the idea that 
many Mac OS users repeatedly fiddle with 
various control panels and change 
preferences. They make these changes for a 
number of reasons: a mobile user who 
travels from place to place needs to adjust 
to those different environments, while a 
home user might have different sellings for 
telecommuting versus playing games. With 
ALM, the chore of going through and 
repetitively changing a large numlier of 
settings is reduced to a single Control Strip 
menu choice, once die collection of settings 
has been given a name. With this named 
collection of settings anti actions, known as 
a “location* in ALM, lengthy lists of 
reconfiguration steps (some users even 
have these taped to their monitors or stuck 


to their keyboards) should become a thing of the past-— provided 
the software they need to configure is ALM-savvy, 

Should you make your software .ALM-savvy? Well, if you have 
a product that has preferences diat die user can change, directly 
or indireedy, die answer is yes! You might think that your 
software's preferences are simple — maybe not much more than 
a simple “on-off or two dmt die user can change widi a click, but, 
in the larger context, the user might want to turn your preferences 
on or off at die same time as changing something else — batch 
reconfiguration is a surprisingly common activity. Consider turning 
file sharing on or off: file sharing is only useful when there is a 
network around, and users might forget to turn it off at 37,000 feet, 
but if they’ve defined a location called “Air Travel 11 that turns it off 
for them (and perhaps turns off AppleTalk and dims die screen for 
better power conservation), they might just get a few precious 
minutes of additional battery life over just dimming the screen — 
but will they remember to do it? With AIM, they only need to 
remember the details when they create their locations — from 
then on, they need only use those locations. 

You might also think that your users generally don’t change 
their preferences, and it's true that many don’t. However, you 
may want to consider whether they would if it were easier and 
could lie done in concert with other changes to their 
environment. Some applications nest their preferences so deep in 
subpanels that the utility of making the change is offset by the 
cost of making it — but what If it were easier? Tm sure you Ye 
starting to see what Vm getting at. 

There are many ways for your .software to interact widi ALM, 
including some 1 probably haven 1 l thouglit of. Ill present some in my 
allotted space, but please do get in. explore, and create things dial 
just make sense — the ideas are simple, but the uses are numerous! 


Erik Sea CseaQapple.com) Erik arrived at Apple about a year ago, widi the sole objective of inundating the PowerBook Division 
with slinkys — so far, diey remain confined to iiis office, except on weekends when they explore die building and feed on 
weak or infirm paper dips. When not tweaking Location Manager code or die MM web site, he can lie found volunteering his 
time to rearrange sets of encyclopedias so that the volumes mn from right to left on the shelf (because that's the way die pages 
are aligned), or writing games in COBOL on Ids Apple ///+. 
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Ways and Means 

A developer once commented to me that AIM is one of the 
simplest* yet most complex pieces of system software to come 
along in a while. While you may shy from such paradoxical 
remarks, they correctly reflea the continuum of development 
options at your disposal — ALM-savviness can take many forms, 
ranging from tight integration with your software to standalone 
ALM modules written by third parties for your products. 

One of the first ALM modules written outside Apple was 
an ALM module for Apple's OT/PPP developed, as shareware, by 
Prime Computing Systems and available on the web at 
<http://www,primecs.com>, 

ALM modules are generally self-contained preference- 
swappers that cooperate to varying degrees with the software 
Lhat owns the preference in question. The tighter the 
integration, the better the user experience, but you can 
certainly start out with looser coupling and improve it as 
revisions to your product permit. ALM modules implement 
some or all of the ALM module API. and are placed in the 
Location Manager Modules folder, inside the Extensions folder. 
I’ll discuss module development shortly, 

TTiere are other types of ALM modules, called action 
modules, that, rather than swapping preferences for a piece of 
software, perform an activity that may or may not be associated 
with a specific piece of code, but just automate the process of 
doing some sequence of steps during a location swatch: opening 
a file, for example. For more on action modules, and die slight 
differences between their API and the API of standard modules 
(for example, one of the "optional' 1 calls for a standard module 
becomes "required” for an action module), see the ALM SDK. 

To find the latest ALM SDK, go to our web site at 
http ://devworld.app1e.com/dev/alm/, or see the Mac OS SDK on CD. To 
take advantage of the newer features of ALM 2.0, be sure you're 
using the SDK's interfaces and libraries — older versions of these 
components may have come with your development environment 
and don't have all of the new features. See "Whatcha Got?" for 
information on testing for the availability of features. 

The ALM engine — that is, the part that provides the core 
services related to switching — has a public API that developers 
can use to enumerate the user’s locations, create new locations, 
or switch locations. WU cover the ALM API later. 

Finally, although .ALM modules can provide a great deal of 
flexibility to a developer who wishes to become ALM-sawy, but 
there are cases where a piece of software might Ixmefit from a 
deeper knowledge of wliat the engine is doing. there is the Aid, 
as mentioned earlier, but you should know dial it can be used in 
clever ways dial might be appropriate for some software diaL would 
benefit from even tighter integration with ALM. A hypothetical 
example of this kind of location-awareness, going beyond mere 
ALM-savvincss, is discussed in the latter part of this article. 
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WHATCHA GOT? 

As with any system software from Apple, there are means 
for testing what features are present in ALM, since the 
features have changed from version 1.0 to 2.0. 

gestaltALMVers 

This selector returns the version of the ALM engine that is 
installed on the machine. 

gestaltALMAttr 

This selector returns a bitfield representing engine 
functionality with the following bit meanings: 

* gestaltALM Present is on if ALM Is installed; it's possible, on 
some hardware, for the selector to be defined but for this 
bit to be off, so check! 

* gestaltALMHasSFLocations is on if the Get, Put, and Merge 
location calls are implemented. 

* gestaltALMHasCFMSupport is on if the engine recognizes 
CFM-based modules, othenMse only Component Manager 
modules are directly supported. 

* gestaltALMHasRescanNotiflers is on if notifications for 
changes in the names or number of locations will be sent via 
callbacks and Apple events; otherwise, only notifrers for 
switches are generated. 


With so many options to choose from, it might take a while 
to figure out how your software and ALM might collaborate. So, 
as you dive into the rest of this article, keep in mind that there 
is often more than one path to AIM-nirvana, er, sawiness, but 
the sooner you start, the sooner you'll arrive, .Setting aside 
philosophical opinion, let's look at the path most traveled first. 

Magnificent Modules 

For mast situations, the ALM module provides the easiest 
and best-encapsulated way to get your software plugged into the 
ALM engine. The calls that an ALM module supports are very 
general; a module (or any software it interoperates with) doesn't 
need to know anything about locations or how the ALM control 
panel works, just how to interact w ith the software it represents. 

Just What is a Module Anyway? 

It is difficult for me to describe what an ALM module Ls or 
does without showing how the user interacts with them. To 
define a location, the user runs die ALM control panel, and picks 
“New Location* from the File menu. All location editing is done 
from the main window, seen in Figure 1 . In the top pail of die 
window, we see the current location (that is, the location a user 
switched to in the past or the location die user is ' in” right now) 
specified by a pop-up. The user can switch from this pop-up or 
switch from a similar menu in the control strip. 
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Figure L Apple Location Manager main window t 
in expanded mode. 

The disclosing triangle toggles display of the Ixittom half, 
where a second pop-up shows the name of the location to he 
edited. As you can see, it*s possible to edit locations that are not 
the current location, which creates some special issues you might 
have to deal with. More on that later. 

At the left side of the window, we see a list of modules that 
ALM knows about — they are located in the Location Manager 
Modules folder. Fach of these modules has a value associated 
with the edit location, and a description of that value is displayed 
al the right when the associated module is selected at the left. 

Modules are ordinarily listed in alphabetical order, anti the 
list order is the order that the engine applies changes when 
switching. The user can, using menu options, move modules 
around in the list to achieve different results tit's often handy, for 
example, to have modules that might require a restart, such as 
Extension Set, first, so that other modules, such as Auto-Open 
Items, could decide to defer execution until after the restart). 

Modules could also be in the list several times if the user has 
chosen to duplicate them (another menu option). For example, 
a user might have several instances of Auto-Open Items 
sprinkled throughout a location definition, doing everything from 
mounting servers to executing AppleScript scripts. 

The value for a module within a location is saved whether 
the module is on or off — this allows the user to temporarily alter 
the location by excluding a module's setting without losing the 
settings established for it. 

Only a few calls are necessary to support everything .seen in 
the control panel. 

If you're concerned about supporting ALM 1.0, rest 
assured that, despite the vast difference in appearance of the 
control panels, ALM 2,0 calls modules with the same expectations 
as its predecessor, but if you want to work under both versions, 
you'll have to take care not to use any 2.0 features. The bottom half 
of the new control panel corresponds to the separate Edit Location 
window in the old control panel, and the new M on-off B checkbox 
corresponds to "adding* a module to a location in 1.0. There's some 
information displayed in the old interface that isn't anywhere in the 
new one for simplicity and performance reasons. 
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WiiAT a Module Needs to Know to do 

Essentially, an ALM module only needs to know how to 
interpret the settings of die software it supports, how to change 
those settings, and how to get those changes recognized. Welt 
discuss nuances in a moment, buL here are the calls a module 
absolutely nrnsi handle (for both ALM L0 or 2.0). 

pascal OSErr CetCurrcnt (Handle setting); 

When a nxxlule receives this request, it resizes the handle to 
whatever size Ls necessary to store the current setting. It is 
generally a good idea to "version" this information, in case you 
decide to change it later. In addition to the version you should also 
store in the handle enough information to restore the setting when 
ALM calls your module with the handle at a later time, Ihis handle 
is stored on disk in a location file, so be sure youVe "flattened" it 
out (that is, there are no pointers to things in memory that might 
not be in the same place when your module is next called). 

pascal OSEri SctCurrent (Handle setting. ALHRebootFlags- flags): 

Modules receive this call during a switch. The setting will be 
one which your module has previously returned from a 
GetCurrent call, though, obviously, it may have been stored 
some time ago. Be aware that, because ALM allows a user to 
switch location very early in the boot process, you need to check 
for things that may not be around yet (such as the Process 
Manager). If the environment is too hostile for your tastes, your 
module should return kALMDeferSwitchErr in response to this 
call, and ALM will try again later in the boot process. 

The flags parameter is used to communicate to die engine 
what the impact of the setting change was, so that the user can 
be offered the opportunity to restart, if necessary. Possible 
responses include kALMNoChange if the settings did not actually 
need to be changed, kALMAvailableNow if they can be used 
immediately, or k ALM Extensions if a restart is required (in which 
case the user will lx: given the option to reboot their machine) 
— see the SDK for additional values and their meanings. Note 
that the input value of the flags parameter is the current 
escalation of the switch process, as set by previous modules. If 
the reboot level is already too high, you can set the flags to 
whatever value Ls appropriate for what you actually did. and 
return kALMHebootFlagsLevdErr as the function result. 

The input value of flags in ALM 1,0 is always 
kALMNoChange, and there is no way to determine what the 
reboot escalation level is when you are called. You shouldn't return 
kALMRebootFlagsLeveJErr if the input escalation level is 
kALMNoChange unless you know you're under 2.0. 

you should avoid forcing the user to reboot when they 
switch your sellings — your customers will thank you for saving 
them time and trouble. Possible strategies include defining an 
Apple event or other signal that your software will recognize as 
“read your preferences now", then send that signal from your 
module's SetCurrent function. 
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pascal OSErc CoropareSetting (Handle settingl, Handle setting. 
Boolean* equal): 


This call is made to determine whether two settings represent 
the same values from the point of view of the module. This is 
used at different times and in different ways, and has a special 
interaction with the optional EditSetting call, discussed later. 

You'll find that this call is made less often under AIM 2.0 
than it was under the older version, because of III changes, but AIM 
2.0 still requires it, 

pascal OSErr DescribeSetting (Handle setting, CharnHandle rext): 

Generate a textual description for one of your settings, 
resizing the CharsHandle as appropriate to fit the text. Don't go 
overboard in your description — the window containing the 
description is resizeable, but try to fit your description in the 
minimum window size for best results. The script system used 
will he UuiL returned by ihe GetScriptlnfo call, described shortly, 

par.cal OSErf Descr 1 bcError (OSErr lastErr h Str255 trrStr); 

You are encouraged to return your own (positive) error 
response values from a module API call, and you II get first crack 
at telling the user what they mean. If you don't wish to describe 
an error, return paramFrr in response to this function, and the 
control panel will present it to the user as a number (boo, hiss). 

pascal OSErr GetScriptlnfo (ALMSorIprMnnsgerTnfoPtr fnTo): 

This call, though technically optional, is pretty easy to 
implement, and is recommended if you expect your module to 
be used worldwide. The format of info is as follows: 

typedef struct I 

Sint16 version: 

Sint16 scriptCode; 

SIntl6 regionCode: 

SIntl6 langCode; 

SIntl6 fnntNiun; 

Sint 16 fpntSlae; 

) ALMS cript Manager Info ; 


You should set the version to kAIMSeriptlnfoVersion, and fill 
in the font and script manager information in accordance with 
how you wish your text to be displayed. If you don't do ibis, you 
might not play well in other languages, because the system will 
fill out the script infonnation on your behalf, and your module 
might end up getting displayed in the wrong script — certain 
characters do not translate well, to say the least. It is actually 
possible for modules to be of different script systems yet be 
displayed correctly. If you plan to localize your text, you II 
probably want to put script information in a resource tint gets 
localized at the same time. See the sample code in the SDK for a 
good strategy to do exactly that 


pascal OSErr Get Info (Charsllaadltt* taxi, STIUmdle* style, 
HodalFilterUPF filter): 
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The Gellnfo call is made to tell the user what your module 
is all about, such as what other software it interacts with. There 
are essentially two favors to this call: in the first, you simply 
return styled text using the first two parameters, and it gets 
displayed, as shown in Figure 2. The text can l>e any length, but 
don't write a book — say what your module does, what software 
it works with, and where to go for more information. 

In the second flavor of Getlnfo, the module iLsdf takes care 
of displaying whatever dialog it chcxises, or perhaps opens an 
AppleGuide window, and returns NULL in the first two 
parameters to signal that it did the job on its own. 



Figure 2 * Control Panel Displays Results of Getlnfo Cali , 


MODULES OR APPLESCRIPT? 

At first glance, it may seem that AIM modules and 
AppleScript are two technologies vying for the same role, for 
if every preference-generating piece of software were 
scriptable, an intelligent user could just have a collection of 
scripts to effect a location switch. 

If you look deeper, though, you'll see that these 
technologies are complementary: a totally scriptable control 
panel, for example, even if it were recordable, would benefit 
from the centralized, simplified process of location definition 
and aggregation with other settings. At the same time, it is 
much easier to support ALM in a control panel that has 
already been made scriptable because the requisite code 
factoring makes ALM support a breeze. 

Still, you do not need to be scriptable to support ALM, 
and, though I would prefer that you did make your software 
scriptable, you don't need to do it for ALM. 
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The filter parameter to the Getlnfo call is a legacy 
parameter, used only in ALM 1,0, AIM 2,0 does not require you to 
call filter explicitly, but you may do so. 

Those are the basics; the SDK provides a good sample 
implementation you can start from, in the form of the “Generic"" 
module, which is particularly handy for prototyping. 

In fad the Generic module could theoretically be used with only 
a few changes in resources, and, for some limited-use applications, 
or for prototyping, that might lx: enough, but ii J s probably not up to 
the quality' required for commercial or even shareware release. 

Though these calls are enough for ALM to work correctly 
and predictably, ihere has yet to be an API devised whereby 
you can become “savvy” by supporting just the lowest level, 
so let's go up a step. 


DUAUNG SETTINGS 

Over the last little while, people have begun to 
recognize the value of storing named configurations, or 
sets of preferences, for easier retrieval by users, This is a 
good thing, and is a move in the direction of ALM. An ALM 
module that deals with a piece of software that already 
supports named configurations probably just needs to 
track the name, and that makes life much easier, because 
you basically are dealing with just a reference to other 
data, rather than the other data directly. 

There are, however, complications, such as the need to 
define dual formats for your settings: normal (in which case a 
reference to other data on the current machine is adequate) 
and import-export (in which case you need to recreate the 
entire setting for use on another machine). 

Another question is what happens if the user changes the 
named configuration — will your module know how to track 
the change and update its reference? 

And how will your module help Bob import "My Reactor 
Settings" from Anne's computer, without wiping out his 
existing (and potentially different) "My Reactor Settings"? 
Maybe he really wants to replace them, but maybe he wants 
to rename the import as “Anne's Reactor Settings". 

You'll have to solve the reference-tracking problem for 
yourself, but ALM does provide a call to handle import 
name collisions, called ALMConfirmName, discussed in the 
API section. 

Of course, if your setting is very simple, such as on or 
off, both formats of your setting can be the same, and 
your implementation of ImportExport becomes very simple 
— just return no Err. 

The remaining bits are not currently used. 


What a Module Should Know to do 

With some additional work, you can provide the user with 
additional ALM-suppoited functionality and achieve ALM- 
sawiness. The capabilities you’ll need to tackle are editing of 
inactive settings, and import-export. If you don't implement these 
functions to at least some extent, not only will you fail to enter 
the blissful state of ALM-sawiness, but your customers may 
become confused and you’ll have a recurring dream in which you 
read Inside Macintosh: AOCE Application Interfaces word for 
word, from cover to cover, until your conscience makes you 
support these added functions. 

This setting must change As mentioned earlier, it's possible 
for a user to edit the settings from one location while being in 
another. Through use of the "Apply" button (refer to Figure 1), the 
user can change a setting in a location by capturing the current 
value of the setting on the computer. This is done through the 
GetSetting call described previously. In user studies, we found that 
it's highly desirable for the user to be able to change settings in an 
inactive location without changing the live system settings (we do 
provide a way to reassert the current location's values). Unto this 
desire, the EditSettlng call was born. 

pascal OSErr EditSetting, (Handle setting]: 

The EditSetring call is optional, but very strongly recommended, 
The input setting parameter is one that will have come from an 
earlier call to GetCurrent. Do whatever you need to do to edit the 
setting, and return either the same one ( if the user cancels the edit) 
or a different one (if the user accepts the edit). When I say different, 
I mean different enough that your CompareSeliing call will say, “Yes, 
the/re different" — if there was no real change, your module might 
just flip a bit in the setting handle that it would ignore everywhere 
hut on a GdmpareSetting call. The reason for requiring Lhese settings 
to seem different even if they aren't is a subtle bit of U1 trickery in 
the AIM control panel: the control panel will automatically mm a 
setting on if, as a result of an EditSeuing call, it can be ascertained 
that the .settings were accepted by tire user. The control panel makes 
the determination of acceptance based on the input and output 
setting handles being different. 

Implementing the EditSetring call can be done in a number of 
ways. Ideally, an EditSettlng call would bring up the same interface 
you use in your software to edit your live preferences, but without 
affecting those live preferences — a sort of “preference U1 
factoring", if you will Alternatively (bur less desirably), you can 
take some son of middle mad, ranging from explaining to the user 
where they should go to edit their live system settings (and 
reminding them to put those settings back the way they were), to 
providing a little JJ platfomT from which lo launch your software, 
perhaps under AppleScript control. 

The EditSettlng call was supported under ALM 1.0, and in fad, 
it's required for adion modules, There is, alas, no support for 
EditSettlng of standard modules in the old control panel so be 
aware of that limitation if you plan to support both versions of ALM. 
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If you don't implement EditSetting, the ALM control panel has 
no way of knowing where your setting comes from, so it displays the 
message shown in Figure 3 when the user tries Lo edit your selling. 


H lhis Setting cannot be edited within Flppte 
Location Manager. You must change the 
current uatue for this Setting, then click 
“Apply” to store the uolue in this location. 



Figure JL Developer Raspberry: Module does not support EditSetting, 

I can't encourage you strongly enough lo implement 
EditSetting to some extent in your initial release, and then 
refine it over time (if you don't go all the way up front). fve 
seen hours of videotaped user experiences, and the 
EditSeuing capability more closely reflects how users expect 
the machine to behave, so don’t let them see this brick wall 
of an alert when they use your module. 

Duties Paid: Importing and Exporting 

It would be really nifty for a user if, once they've honed a 
location to near perfection, they could share it with others. It 
would also Ik" nice if, walking into a new environment, a user 
could receive a group of settings that other people in that 
environment use. That, in a nutshell, is what the IniportExpoit 
capability is all about. 

pascal OSErr Import.Export (Boolean import, Handle setting, 
STrvtlf* resRefWtim): 

The settings dealt with by most of the API can be small 
— they may just be references to other data structures (1 
would encourage this design decision, though it introduces 
some new issues as discussed in “Dualing Settings"), and that 
will work fine on one user's computer. If you were to export 
just the name, however, the importing machine might not he 
able to interpret it correctly. 

So, when you export, you might want to augment the setting 
handle with additional information that would allow you to 
replicate the setting on another machine (short of actually 
installing software on that machine!), and, on import, you can 
decode that information and shrink the handle back down to 
si2e. If that technique isn't enough, or you'd rather keep your 
setting the same, you can add resources to the exported location 
file, and read them in on imporL (after you read your resources 
in, you should delete them, since you're actually working on a 
copy of the import file, in the legations folder, rather than the 
actual import file). You should use a unique resource type, such 
as your creator, for die resources you use. 

If you don’t implement ImportExport, be sure to document 
this tn your Getlnfo window information. 


Now that you know how modules work and how ALM 
calls them, let's go to the other side of the fence and see 
how to call ALM. 

Start Your Engines! 

The ALM API contains a series of calls for the developer to 
find out about a user’s locations, a call to initiate switc hes, calls 
to create or let the user merge a selling into a location, plus events 
and notifications to determine w r hen a switch has occurred or a 
location has been created. As mentioned previously, there is also 
a call to handle import collisions in a uniform way. 

Tm API 

The ALM API is accessible in C, Pascal, or Assembly, from 
PowerPC or 68K, in classic or CFM-68K runtime models. 

Since CFM-68K calling isn't available under ALIVI 1,0 1 
recommend weak-linking with the CFM68K stub library and then 
testing against API symbols at launch. 

What place Is this? 

If you want, you can take a gander at what the user has set 
up. Perhaps you want to build your own pop-up menu to 
provide the user the ability to switch locations from within your 
application, rather than the control strip or control panel. Here 
are the calls, and a very simple program to use them can be 
found in Listing 1. 

pascal OSF.rr ALWR^tCurrentLocation (SInti 6* index, 

ALMToken* token, 

ALWLncationNamf! name); 

pascal OSErr ALHCoirntLocaLions (SintI6‘ Incat IonCount); 
pascal OSErr AlMGetlndLocation (SlntX6 index, 

ALHToken* token, 

ALMLocatitmNsme name); 

The indices in these calk are zero-based, so the maximum 
wih be one less than the locationCnunL The special index value 
kALMNoLocaiKjnIndex denotes the situation where the user has 


listing 1 Printing the User's Defined Locations 

ALMToken curLocToken, locToken: 

ALMLocationNama curLocHame. 1ocName; 

Sint!6 mifflLoce, loclndex; 

print! {"User Locations on this Machine:Vn“); 

err - ALMCountLocaLions (AnumLocs); 

print! (“There are %d locations In totsHn", numLoos): 

err - ALMGetCurrentLocation (NULL. k'urLocToken, 
curLocName): 

printf ("The active location is %s\n“, 
pZcstr (curLocName)); 

for (lor.Index = 0: locIndex < numLocs: locIndex += 1) I 
err “ AlJHGetTndLocation (locIndex, ilocToken, 
locName); 

if (locToken I ” curLocToken) // special treatment! 
print! (“Location %d is %s\n H , loclndcx, 
pZcstr UocName)): 

else 

printf (“Location %d is the current iocation\n“, 
loclndexj: 

1 //for 
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chosen the special location "None (Off)". ALMTokens represent 
references to locations for use* in other calls (anti the special value 
kALMNoLocarionToken corresponds to kALMNoLoeaiionlndex). 
If you only want certain parameters to be returned* it's legal to 
pass NXJ1X for any pointer. 

Snapshots — as Pretty as a Picture 

In AUV1 2.0, there are functions that you can use to interact 
with the user much like the control panel does. You should 
gestalt these functions (see “Whatcfaa Got?”) before using them. 
Ihe user experience is very much like Lhe Standard File package, 
only simpler, but the calls themselves take care of a lot of 
additional work for you. 

Sometimes, you'll warn the user to simply choose a location 
from a list without need for iterating across all installed locations and 
building your own UI. To ask die user for a location, use the 
AlMGetlocation call, which presents a dialog as shown in figure 4. 



Figure 4 . Asking the user for a location with ALMGeiLocaiion. 


pascal OSErr AUKtatlocation (CuiistStrZSSParsiti prompt, 

Str31 locationName, 

KodalFiiterTDUFP filter, 
void* yourDataPtr): 

The prompt is displayed above the list of locations, as in 
Standard File, The locationName is l>oih an input and an output 
parameter — if the name matches a location* that lexmion will 
lx* selected in the list, lhe filter and data pointer are lor your 
own use, again as in Standard File. If the user dicks cancel* the 
function result is userCanceledErr; otherwise, it should Ik* noErr* 
The next two calls, ALMPutXocation and ALMMergeLoeation 
are intended to allow an application, such as a setup program, to 
capture the current system settings for a numlxr of modules as 
a location, or merge them into an existing location. Detailed 
information on module signatures* or types, is beyond the scope 
of this article (see the SDK), but the use of some special values 
for these parameters is shown in Listing 2. 

paflral OSErr ALHPutLocation (ConstStr255Parara prompt, 

Str31 iocatiooNajiie. 

Sint 16 numTypes, 

ConetALHModuleTy pel, ist Pi r LypeLlst 
ModalFilterVUUPP filLcr. void* yourDataPtr}; 
pascal OSErr ALWMergcLGtaiiay tCanstStr2S5Fai:aBi prompt, 

Str3I 1ocationName. 

Sint16 numTypes* 

ConstALMModuleTypeListPtr typelist* 

Hod a i F i 11 e r YFlfPP filter* void* yoiirDataPtr) 


Listing 2 Put Up or Merge Up 
// uraic a flew, empty lucaiion 

err = ALHFutLocation (‘\pName your place". 

*\pEmpty Location", kAT.MAddAl ]0f f * 
HULL* NULL* NULL); 

// add to a location as a snapshot, using all airrvmiy installed 
// non-actk>n modules, replacing current definitions 

err = ALMHergeLocation ("\pRedefine your place*, 
"\p5napshot Location", 
kALHAddAllOnSimple. NULL. NULL. NULL): 


Switching 

There would be very little use to AIM without the switch 
engine, 'this is the caff that the control strip and control panel use 
to effect a change in location: 

pascal OSErr ALHSwitcliToLocation (ALHToken newLocation, 

ALHSwitchActionFlags svitchFlags): 

Most of the time* you can pass kALMDefaultSwitdiFlags for 
the second parameter. For a quiet switch (that is, one in which 
the switching dialog does not come up), pass the mask 
kALMDontShowSLUusWindow. If you’re making this call from an 
unusual place such as inside a dialog filter or some other weird 
place, use the mask kALMSignalViaAE so that the switch will be 
deferred until the ALM control panel (or the Finder, if the control 
panel isn't open) is in a better synchronized state. 

If you wish to switch locations from a background 
application you should use either kALMDontShowStatusWindow 
or kALMS igna I Via A E or both. If you do not, ALM 2.0 will return an 
error. ALM 1.0 is less forgiving, and will crash if the host application 
hasn't inrtiallized the window manager. Moral: don't use default 
flags except in direct response to a user action in your foreground 
application! 

Noticing Switches and Other Goings On 

One of the more interesting things about ALM is that it 
actually tells all running prexesses when ilk* user has changed 
locations, Under ALM 2.0, it'll also advise when the user has 
created, renamed, or deleted a location, so that applications that 
want to know can rebuild any lisi of locations they might have 
internally, or reorganize any data they might have been shadowing 
on a Iocaiion4>y-kxation basis by rescanning the user's installed 
locations using a technique like that of Listing 1. 

You should check gestalt for the availability of the rescan 
notifiers if you’re going to rely on them, as described in "Whatcha 
Got?". If they ate not available, you can employ alternate strategies, 
such as periodically iterating through the installed locations. In any 
case, it's good practice to recheck the installed locations at start-up 
if you save your own list somewhere. 
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Listing 3 Observing Switches and Handling 
Rescan Nolifters 

pascal OSErr MySystamCanfigNoticeHandler 

(const AppleHvent* iuEvent. 
ApploEvctU * reply, SIn 132 rcfCon) 


OSErr err = errAEttescNotFound; 

ALMToken locToken; 

DescType actuallype; 

Size aclualSize; 

// Handle any other cases you like... 

// Did we get a switch notification? 

if (err !- noErr) ( 

err - AEGetKeyPtr (inEvent. 

kAELo c a t i onChan g edNoticeKey . 
typelnteger, factuallype f 
ilocToken, sizeof (locToken), 
factualSisft): 

if (err noErr) MyRoRcaetToSwItell (loc.Token) ; 

if if 

// Did we get a rescan notification? 

if (err ! = noErr) f 

err - AKGetKeyFtr (inEvent, 

kAELoc&tionRe s canUoticeKey„ 
typelnteger. SactualType. 
ilocToken, sizeof (locToken). 
factual Si eg); 

if (orr '■* noErr) MyDoReaclToRescanNotlce 
(locToken); 

) //if 

return err: 

! // SystanC jjntIgN< rtieeHandlcr 


The class of the Apple event is kAECoreSuite, and the event 
ID is kAESysteniConfigNotice, just as with the display manager's 
notifications that the screen size or resolution has changed. If 
your event handler receives such an event, and there is a 
parameter keyed under kAKLocationChangedNoticeKey T rhen a 
switch has occurred, and that parameter’s value is the AlMToken 
of the location to which die user switched. If there is a parameter 
under kAELocationRescanNoticeKey, then the user has made 
changes to the installed locations, and you can’t rely on any of 
your previously stored data about locations being valid. The 
value of the parameter is the ALMToken of the current location. 
For a skeletal handler, see Listing 3- 

Event Me Not 

Of course, if you're a code resource* you won't l>c getting 
many Apple events, so you can provide a function such as this 
as an alternative: 

pascal void MyALMNotificationRoutine (AppieEvent* theEvent): 


Your implementation of this routine ought to be similar to 
the Apple event handler in Listing 3- Create a UP? by passing 
your routine to NewALMNotificationProc, and then register and 
deregister your routine using these calls: 

pascal OSErr ALNRe&i^tcrNotifyProc 

(ALHKoiiricaLionUPP notifyProc, 
const FroceasSeriaLNumber‘ whichPSN); 
pascal QSErr ALHReooveNotifyFroc 

(ALHNotif icatlonllPP notify Proc. 
const ProcessSerialNumber* whichPSN): 

The ProcessSerialNumber parameter is used by AIM to 
ensure that notifications aren't sent ro code whose process no 
longer exists (but for which Lhe notifier was not removed). You 
should pass the serial number you’re associated with. 

Import Collisions 

Particularly if you implement named configurations, as 
discussed in “Dealing Settings 1 , you could have situations, when 
importing, where a setting you're importing conflicts with a 
setting already on the machine. To address this problem, ATM 
provides a routine that displays two dialogs in succession. The 
first asks the user to choose either to rename or to replace the 
named configuration, and the second, shown in case of a 
rename, presents a box in which to rename the configuration. 
The call is as follows: 

pascal OSErt ALMConfirmNauoc (ConstStrZSSFaram mag, 

StJrlSS contigHame. 

ALMConfirmChoice' 1 choice. 

ModalFilterUFP filter); 

If lhe user cancels the operation, the function returns 
use rCa n ce 1 ed K rr; otherwise, Lhe value of choice is 
kALMConfirinRename or kALMConfinnReplace, depending on 
the user's choice. You may provide a filter function, if you 
wish access to evenLs in the dialog. The refcons of the dialog 
boxes disclose which is which, and the individual element 
numbers are provided as constants in the AIM 2.0 interfaces, 
should you wish to do ihings like constrain the allowed 
characters in your configuration name (rather than validating 
the name after the call returns). For details on the refcons and 
item numbers, see the SDK, 


Listing 4 Driving a Switc h from AppleScript 

set someLocatiunNaffle to ‘'Home Office" 
tell application "Finder” 

set cpFoider to (control panels folder as string) 
open file (cpFoIder & "Location Manager") 
tell application “Location Manager" 

set current location to location someLocationName 
end tell 
end Lcll 
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Due to a bug in AIM 1,0 the filter function was not called in 
both dialogs, but just the rename dialog. If your filter function sees a 
refcon of zero, you can assume you are in the 1,0 rename dialog box, 

AppleScript Support 

Alternatively, you can access much of the API by sending 
AppleScript commands to the control panel A simple switch 
through AppleScript is shown in Listing 4. You can, of course, 
also list locations from AppleScript using the Standard Suite. 

Though this API is small, these same bricks will build a 
house or a castle, depending on how you choose to use them. 
Although the water may look deep, location-awareness could 
represent the ultimate offering to the user, giving them much 
more than ALM modules, alone, are capable of. 

Where Am I? 

'Huts far, we've talked about ALM-sawiness and driving the 
engine, but now let’s switch gears a little and talk about the 
greater generalities of location-awareness. 

How a piece of software becomes location-aware is as 
unique as the piece of software itself — it requires planning and 
thought beyond how to simply automate the chore of switching 
preferences. Instead, a location-aware piece of software lias new 
functionality that its location-oblivious sibling does not. 

As an example, let’s Lake the Apple Menu items control 
panel, which has been an indispensable parL of Mac OS from 
System 7,5 to the present. What form could location-awareness 
take in this control panel (see Figure 5)? Suppose that, in each 
location (whether a “location” is a physical location or merely 
a state in which they perform different tasks), the user accesses 
different documents, applications, and servers that are specific 
to that location, but, in moving from one location to the next, 
they constantly wipe out recent items from one place before 
they get back to ft. Typically, users faced with this problem 
combat it by increasing die recent item allocation numbers, but 
while searching through a big list works, it's far from ideal. 



Figure 5. Mock-Up: Apple Menu Items with Location-Awareness. 
PrFFKRHNTIAL TRLiAOSfllNT UNDER APPLE LOCATION MANAGER 


We could just write a module for this that, through clever 
folder manipulation, swapped the recent items around, but 
what about the occasion when the user actually wants to access 
a recent item from another location without switching to that 
location first? Perhaps the submenus could present recent items 
in different ways — the ordinary way most of the time — or 
sorted by location if the user holds down the option key when 
choosing the Apple menu. 

I am not suggesting that the hypothetical example I present 
above is the best possible answer, but I am hoping that software 
developers will consider using location-awareness as a new r way 
to solve problems that their users might lx facing. 

Give location-awareness some thought — it might be 
your best bet. 

Thfre s no Location like Home 

Now that you’ve been through sawiness and awareness, 
modules and APIs, I hope you can see the opportunities ALM 
presents for you to make life easier for your users, both 
mobile and landlubber. 

So take a few moments to install and play with ALM, and 
then play with the sample code. I think you’ll be surprised at how 
much mileage you can get out of a very small amount of labor! 

Thanks to my reviewers Mark Cookson , Dave Ferguson, 
Scott Johnson, Susan Michalak Kent Miller, and Eric Slosser. 
Special thanks to everyone on the AIM team, present and past , 
for your contributions to shaping and sculpting a truly unique 
and innovative piece of software, ifl 

RELATED READING 

• The ALM web page, located at httpV/dewvorld.apple.com/dev/alm/. 

• ALM SDK, available through the web site or on Mac OS SDK. 


Want to suggest 
an article for the 
magazine? 

Send your suggestion to 

<mai!to: editorial@mactech.com> 


In MacTech • September 1997 


86 
















































Developer Depot FO Box 5200 Westlake Village CA 91359-5200 
800/MAGDEV-1 • Outside the U.S. & Canada: 805/494-9797 • Fax: 805/494-9798 
E-mail: orders@devdepot.com • Web Site: http://www.devdepot.com 


/ We lid LeLiuwued 
cable LueL eemce 

/ ULtiei by [lieUe. 

LE-iutiiL lei. ei UiLeiL^li 
eiiL ceidtLaieLly 


/ LliiLidLedb: el 

develeuel ine ducts 

/ ^eublecttee 
end Lewetl LiL ice 
uueLeiiieed 


INCLUDES 
EVEN MORE 
APPLE BRANDED 
DEVELOPMENT 

















I' ■ 










.IS 


Developer To Do List: 

^prioritize project list & generate sch » e 

□ Pickup new Moclech CD-ROM vll 2 

n Check out all the Dev Depot specials I 

^ u_ u * oev Depot deals 

Q Tell the 9ong “bout^ & ^ 

Q Stock up on the lates 

□ Enter Dev Depot info into contact Me 
Developer Depot 

PO Box 5200 01*4co-5200 

Westlake Village, CA 91359 

Voice: 800/MACDEV- ’ , .9^9797 

Outside US/Canada: 805/494 V/v 
Fax: 805/494-9798 

E-mail: orders@devdepot.com 

http://vrwvr.devdepot.com 

17 ._ 

TM 
































now carries Apple 
brand products / 




DEVELOPMENT 
ENYI llONMENTS 


06 

12 

14 

15 


TOOLS, UllS 
& UTILITIES 


INTERNET 

RELATED 


SCRIPTING 


NULTINEMA 



GAMES 


1« 

19 


TRAINING 

ACCESSORIES 


20 


ROOKS & 
REFERENCE 



INDEX 


’Si 





Order Toll-free 
800-MACDfV-l 

■00*2233811 


Developer Depot 30 day Money Back, Price and 
.Satisfaction Guarantee 

Developer Depot products are sold with a 30 Day money hack guarantee on 
user sutLs fact ion, lower prices and against defects, If, for any reason, you are 
not satisfied or tind the same product at a lower price within 30 days, please 
rail Customer Service at KtKtMACDEVd and request a Return Merchandise 
Authorization (KMA) number to get a full refund or ihc difference in price 
(where applicable). You must return unefarnuged product at your expense, 
including all its original packaging, documentation and the blank warranty 


raid if applicable Developer Depot wilt replace defective product upon 
receipt of the defective merdtandise. Please remember to back up your data 
Ijefore installation til any new hardware, software. or peripherals; we cannot 
he responsible for any lost data. Policies, item availability, and prices are sub¬ 
ject to change will tout notice. The price in effect when we receive your order 
wall lx k the price that you are c harged We are not responsible for any typo¬ 
graphical errors in tJus or any other catalog, nor for any misstatements from 
any vendor Purchase orders are not accepted without prior approval. Call for 
more information. 


Stuff our lawyer made us write, 

Devditfier Derxu makes no other warranties. All other warranties, either expressed or implied, including the implied warranty of tnen hamalwliry and fitness for a particular purpose 
are disclaimed Developer Depot shall not Ik- liable for any direct, sjvenal, imHdenta! or t onset [ueutial damages including lost profits, from any delay in delivery, or for isnyjKrisore 
al injury arising from the use of any produet sold through IX- velojXT Depot. The limit of direct damages, il any, shall thu exceed the purcluk* price of tile product. E> 1997 Xplain 
Corpora I ion, Ml rights reserved. Any unauthoriMd duplication is in violation of federal laws fX-vdoper Depot Ls a registered trademark of Xplain Corporation, All product names in 
this catalog are die trademarks of their respective holders. 

c ' 1997 Xplain Corporation. All rights reserved Any uuautlKirixed duplication is in violation of federal laws, Developer Depot is a trademark of Xplain Corjwnation* All piXKluct names 
in this catalogue are trademarks or registered trademarks of their respective lioklers 


TARLE OF CONTENTS 





























CodeWarrior 


Professional Release 1 

by Metrowerks 


More platforms, more languages, more 
options: CodeWarrior Professional is designed to give you the 
tools you need for serious, industrial-strength programming, 
CodeWarrior Professional is the only Integrated Development 
Environment (IDE) in which you can edit, compile and debug C, 
C++, Java and Pascal programs for multiple target processors 
and operating systems. CodeWarrior's compilers produce fast, 
highly optimized code for Windows 95/NT running on x86, or 
Mac OS running on 68K or PowerPC processors. CodeWarrior 
Professional features the new CodeWarrior IDE Version 2. The 


newly revamped Project Manager supports multiple projects 
open simultaneously, multiple targets per project, and threaded 
execution, plus it’s significantly faster. CodeWarrior Professional 
also includes online books, documentation, and reference 
materials, as well as tutorials and sample code. We support 
your development efforts with one free update and free world- 
class technical support for a year with registration. 

• Includes Windows 95/NT and Mac OS versions of the 
CodeWarrior IDE 

• Supports C, C++. Java and Pascal 

• Develop for Windows 95/NT on x86 and Mac OS on 
68K/PowerPC 

• New Project Manager supports multiple open projects, 
subprojects, multiple targets per project, and threaded execution 

• Integration of tools means you spend less time navigating and 


more time coding 

Upgrade for competitive product owners 
(SCWPRUP) Our Price $449 
Full Version 

(SCWPRO) Our Price $599 



CodeWarrior 
for BeOS 3 

by Metrowerks 


Be 

OS 


• Start programming lor the new, innovative Be Operating 
System (BeOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment (IDE) with all 
the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax color 
and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C++ classes, and sample code 

• The Be Operating System Advanced Access Preview Release 
allows you to run and program for the BeOS on a 603 or 604 
PC! based PowerMac 


(SCWFB) Our Price $299 
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CodeWarrior for 
PalmPilot 

by Metrowerks 

CodeWarrior for PalmPilot is the first complete set of tools which 
enables you to develop for the U S. Robotics PalmPilot 
connected organizer, from the comfort of your PC or Macintosh 
computer. All the tools you need are included: the award - 
winning CodeWarrior IDE, compiler, linker, source-level 
debugger, GUI builder, and other tools, plus online 
documentation and reference materials. Includes one year of 
product updates and free technical support. 

(SCWPALM) Our Price $369 





CodeWarrior Latitude 

by Metrowerks 

Don’t throw away the investment you have 
made in your Mac OS applications! With 
the DR/1 release of CodeWarrior Latitude, 
you can prepare your Macintosh 
applications to run native under Silicon 
Graphics IRIX or Sun Solaris (and soon, 

Rhapsody), Begin work now to prepare 
your Mac OS application to run native 
under Rhapsody, By compiling and linking your CodeWarrior project 
with the Latitude libraries, you can identify which portions of your 
code will port smoothly and which Mac Toolbox traps are not 
implemented. Additionally, you can expand the market for your Mac 
OS application by completely porting it to Silicon Graphics IRIX or 
Sun Solaris at a fraction of the cost of other porting tools. 

As the Rhapsody API evolves, so will Latitude. Registered users of 
CodeWarrior Latitude will receive all developer releases, the first full 
release, plus one additional product update, to ensure that you have 
access to the most up-to-date Rhapsody porting tools available. 
(SCWLAT) Our Price $399 


MW Visual SourceSafe ^« 0BueT! 
Release 5 

by Metrowerks 

• Source code control system, plug-in 
to the CodeWarrior IDE 

• Compatible with Microsoft Visual 
SourceSafe version 5.0 

• Cross-platform support (Mac, 

Windows, UNIX) 

• Configuration management in excess of 4 billion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users receive one year of free technical support 
and one free update 

(SMWVSS) Our Price $499 
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CodeWarrior 

Discover 

Programming 

Edition 

by Metrowerks 




• Learn to program in C/C++/Java/Pascal 

• Full-featured programming product - not a “file" edition 

• Online books and tutorials 

• Hosted on either Mac OS or Windows 95/NT 
CodeWarrior Discover Programming Edition offers an unbeatable 
combination of full-featured programming tools, online books 
and instructional materials, all at a great price, Whether you 
want to learn the basics of programming or add a new language 
to your skill set, Discover Programming puts the information and 
tools you need at your fingertips; the award-winning, easy-to- 
use CodeWarrior Integrated Development Environment (IDE), 
four of the most popular programming languages, online books, 
online tutorials, sample source code and free technical support 
{with your registration). Discover what you can learn with 
CodeWarrior, buy your copy today! 

(SCWDISCMAC) Mac OS Our Price $79 
(SCWDISCWI) WIN 95/NT Our Price $79 
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tg| Apple Dylan 


Apple Dylan Technology Release 

by Apple Computer, Inc. 

• Contains a PowerPC-native prototype version of a development 
environment based on the Object Oriented Dynamic Language 
(OODL) Dylan. Developers will be able to produce code targeting 
both 680x0 and Power Macintosh systems 

• Automatic memory management 

• Application framework and user-interface & builder 

• High-level exception handling 

• Cross-language support for C code and APIs 
CD & Online Documentation 

(SADTTtO) Our Price $39.95 
CD & Hardcopy 

(SADTRH) Our Price $59.95 


Newton Toolkit 1.6 W 

by Apple Computer, Inc. 


With Newton Toolkit, you can easily create software that runs on any 
Newton PDA, including Apple’s MessagePad and Motorola’s Marco. 

• Now supports Newton 2.0 

• Dynamic Language Eases Development 

• Allows you develop applications interactively 

• New Compiler Enables Faster Applications 
Newton Toolkit 1.6 


(SNETO) Our Price $149 
Newton Toolkit Update 1.6 
(SNETOUP) Our Price $29 



Newton 


Newton Toolkit 1.6 for Windows 

by Apple Computer, Inc. 

With Newton Toolkit, you can easily create software that runs on 

any Newton OS device from Apple or its licensees. The Newton 

Toolkit is a development environment that reduces the complexity 

and time Involved in creating great software products. 

• Provides access to features specific to the Newton 2.0 OS - Allows 
developers to create new or modify existing Newton applications to 
take advantage of powerful Newton 2.0 OS features 

• Supports Windows 95, Windows NT 3.5x, and Windows 3.1 (with 
Win32s) operating systems -Enables developers to use multiple 
development environments/operating systems when creating 
Newton applications 

• Includes Macintosh-to-Windows NTK project converter tool - 
Allows developers to automate conversion of existing NTK projects 
from Macintosh platform to Windows platform 

• Provides NS Debug Tools - Allows developers access to interactive 
Newton application debugging tools. Offers extended NewtonScript 
debugging functions, which let developers study and manipulate 
an application running on a Newton device. Developers can use 
NS Debug Tools to set break points in an application after it’s been 
compiled and installed, step through program execution, examine 
and change objects on the Newton, and display a textual 
representation of the interpreter instructions 

(SNETOW) Our Price $149 
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MkLinux: Microkernel 
Linux 

for the Power Macintosh 

by Prime Time Freeware 

MkLinux is a native port of Mach 3 and 
the Linux 2.0 kernel, complemented by hundreds of commands 
from BSD, GNU, and XII. It runs on most (NuBus abd OCU bus) 
Power Macintosh systems; Performa, PowerBook, and 
multiprocessor ports are currently under development. 

MkLinux is robust, powerful, freely distributable, and source code 
compatible with most other Linux systems. It provides a full suite 
of development tools, support for AppleTalk, HFS, and Objective- 
C, and access to a vast amount of free software. MkLinux is a 
great way to "come up to speed" on Mach, UNIX, and Rhapsody. 

• MkLinux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference release contains a wealth of 
introductory and reference material on Linux, Mach, NeXT, and 
the Power Macintosh 

• Includes free 3.0 upgrade 
(BMKLINUX) Our Price $50 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90, VAX compatible F77, and 
C/C++ compilers into a single, easy to use environment. All compilers 
are link compatible and operate through a common interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library, Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatible with Absoft F77, C++, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 
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800-MACDEV-l 

BCMJ2-33SH 


VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create full-featured, stand-alone 

Macintosh and Power Macintosh applications in standard BASIC code! 

VIP-BASIC 2.0 is the fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASIC high-level subprograms 

• Import pre-existing BASIC code: automatically integrate BASIC 
code, export C Code for compiling: automatically convert your 
BASIC code to C for compilation with Metrowerks 1 CodeWarrior 
(SVIPBASIC) Our Price $195 




Macintosh Common Lisp 4.0 

by Digitool, Inc. 

Macintosh Common Lisp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, and academic research. 


• Power PC native environment & compiler, full Macintosh support 


VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger, Import pre¬ 
existing C code: automatically integrate C code with a current project 

• Includes full-featured mini database: (ltd lo 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multi-user database applications 

(SVIPC) Our Price $295 



• CLOS, the standard Common Lisp object system 

• Interactive dynamic environment, multiple processes 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiles with Common Lisp industry standard and smart 
programmable tools, 110+ mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and registration card 
(SMCUSP) Our Price $675 
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ObjectMaster 
Professional Edition 

by Attura Software, Inc. 




Object Master is an innovative programming environment that 
provides all the necessary tools to write, organize, and navigate 
through source code. 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly access and 
manipulate ail files 

• Navigate through source code using intuitive graphical 
Browser windows 


(SOMPE) Our Price $399 


Roaster 

by Roaster Technologies, Inc. 

Roaster Release 3.1 is now available 

with JDK 1.1 and JavaBean support! 

Getthe most out of Sun’s Java™ 

programming language with this 

powerful development environment. 

• Features include: ability to build 
stand-alone Macintosh applications 
or applets; visual interface builder; ability to create cross-platform 
zip files; powerful Java debugger: wizard for quickly creating Java 
applets or applications; JavaBean support; JDBC support; Java 
object database included; ability to call AppleScripts from Java; 
Just-in-time {JIT) compiler; JOK1.1 x support; class tree and 
hierarchical class browser; much more! 

• Software includes: Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design’s PSE for 
Java; OpenLink Software's JDBC Drivers; OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3.0; much more! 

• Requirements: Runs on 68k or PowerPC. CD-ROM 

• Price includes all web-based updates 
(SROAST3) Our Price $99 



NS BASIC 3.6 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host is required 

• Create files, access the built in soups, and the serial port for 
input and output 

• Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

• Get the BASIC Internet Tool, available at no charge lo NS BASIC users 
from www.nsbasic.com 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Also runs on MP 1201s with NOS 2.0 that 
have full memory available 

• Write short programs to access News, mail and the web 
(SNSBASIC) Our Price $99 



/# r TENON 

/ f f/ INTERSYSTEMS 

CodeBuilder 

by Tenon Intersystems 


CodeBuilder is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 


• A powerful Macintosh software development tool suite ot C, C++, 
Objective-C, Java, Ada. and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C++, Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl, MacPerl, tcl/tk, bash, sh, and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 


••• 


WAIT' 

There * Here’s a list of all available products. For full product descriptions 
jyiore! please see our Web site, or feel free to call, fax, or E-mail us. 


^ PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAD 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSFORT 

595.00 

LS Fortran Plug-In 

SLSFPI 

199.00 

Mac FORTRAN II 

SF0RT2 

595.00 

Power MachTen-UNIX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGIC 

15.25 

SmalllalkAgents 

SSTA 

695.00 

Think Pascal 4.0 

SPASCAL 

165.00 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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TOOLS, LIBRARIES & UTILITIES 



ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for integrating 
Internet e-mail in your applications 

• Helps you write software that 
can share mail with other leading 
e-mail products 

• Royalty-free MIME, SMTP, and 
POP3 APIs 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 



r-tree Report Generator 

by Faircom 

Handles virtually every aspect of report 
generation: 

• Complete C source 

• Complex multi-line reports 

• Multi file access 

• Complete layout control 

• Conditional page breaks 

• Nested Headers and Footers 

• Horizontal Repeats 
(SRFRG) Our Price $445 



Spellswell Plus 2.1 

by Working Software 

• Award-winning, comprehensive, practical spelling checker that 
works in batch mode or within applications that incorporate the 
Apple Events Word Services protocol (e.g., Eudora, WordPerfect, 
Communicate!, and InfoOepot) 

• Checks for spelling errors as well as common typos like 
capitalization errors, spaces before punctuation, double word 
errors, abbreviation errors, a/an before vowel/consonant, etc. 

• MacTech orders include developer kit with Writeswell Jr„ a sample 
AppteEvents Word Services word-processor and its source code 

• Available for OEM Sales 
(SSPELL) Our Price $49 


c-tree Plus® Database Handler 

by Faircom 

Unsurpassed Cross Platform 
Tools for Mac Developers! 

• Full C Source 

• Ciient/Server Option 

• Over 16 years proven 
reliability 

• Concurrent simultaneous access of Mac/PC files 

• Superior throughput and performance 

• Unparalleled scalability and flexibility 

• Fixed/Variable length files 
(SCTPDH) Our Price $895 



Memory Mine 

by Adianta Inc. 

• Monitor heaps, identify 
problems such as 
memory leaks, and 
stress test applications 

• Active status of 
memory in a heap is 
sampled on the fly: 
allocation in non- 
relocatable (Ptr), 
relocatable (Handle) and 
free space is shown, as are heap corruption, fragmentation, 
and more 

• Allocate, Purge, Compact, and Zap memory lets users stress test 
all or part of a program 
(SMEMMINE) Our Price $99 


ScriptDemon 

by Royal Software, Inc. 

ScriptDemon is a browser plug-in that, for the first time, allows you 
to deliver and run AppleScripts from Web pages. The ScriptDemon 
plug-in will execute the embedded AppleScript code included on a 
Web page. ScriptDemon painlessly and inexpensively handles many 
previously impossible tasks, such as: 

• Using the Intranet to manage all Macintosh computers on-line 

• Using the Internet to Install and configure software 

• Using the Internet to configure hardware 

• Delivering complex sets of files and assembling them on the 
browsing computer 

• Providing interactive education and product support on both the 
Internet and Intranet 

• A perfect companion to UveCard! 

(SSDEMON) Our Price $949 




Guide Composer "" 1.2 

by StepUp Software 


STEP“ P 

SOFTWARE 


• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIWYG development environment: Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same format as the user 
will use them 

• Features are WYSIWYG interface, Topics, phrases, and 
hierarchical phrases, Coach marks, Fully-Integrated with Apple s 
Guide Maker (distributed with Guide Composer), compiles scripts 
automatically, PICTs in Panels, Generated Guide scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http://www.guideworks.com/ 

(SGCOMP) Our Price $99 


SEE RELATED PRODUCTS: AppleGuide Complete. Danny Goodman's 
AppleGuide Starter Kit, Real World AppleGuide 
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VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version 
control tool for all sorts 
of projects (software 
development, 
documentation, design, CAD, publishing, etc.) 

• Smooth integration with Metrowerks CodeWarrior IDE 

• Simple and clear management of variants and revisions of entire 
projects (not only of single files) 

• Easy-to-use graphical project browser gives access to all versions 
that were ever stored. 

• Recording of the complete history (who made which changes 
when and why) 

• View differences between versions (not only for text fites!) 

• Efficient delta storage of arbitrary files (text as well as non text 
files) gains savings of 95 % and more 

• Administration of users with hierarchical access rights 

• Configurable local file locking (Finder flag or 'ckid' resource) 

• Scriptable, essential parts PowerPC native 


Single license (SV00D001) $229 
2 pack (SV000002) $359 
5 pack (SV00D005) $799 
10pack(SV00D0010) $1369 
20 pack (SV00D0020) $2399 


Additional pricing available on request. 

SEE RELATED CATEGORY: Dev. Environments 


StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional replacement for the List 
Manager used by developers worldwide. Version 3.0 is a new 
release with many improvements including better clipboard and 
drag/drop integration with other applications. 

• Available for use with CodeWarrior C & Pascal 

• includes libraries for 68K (A4 & A5) and PowerPC 

• An LTable-like class is provided to incorporate StoneTable into 
the PowerPlant environment 

(SSTONEFAT) 0urPrice$199 


QC 




QC 

by Onyx Technology, Inc. 

High performance runtime stress 

testing for applications. 

• Tests include heap checks, 
purges, scrambles, 
handle/pointer validation, 
dispose/release checks, write to 
zero, de-reference zero as well 
as other tests like free memory 
invalidation and block bounds checking 

• Extremely user friendly - ideal for non-programmer testers 

• Also available in Japanese 
(SQC) Our Price $99 


Ah 'iiS- 
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Spotlight 

by Onyx Technology, Inc. 

Spotlight is a stand alone debugging aid that performs memory 
protection (arrays, heap accesses, outside your heap, low mem, 
etc), discipline checking on toolbox calls, and teaks detection. 

• Spotlight is sold on an annual subscription basis 

• The subscription service provides all updates 

• includes maintenance releases for one year after 
the initial purchase or renewal date. 

(SSPTLT) Our Price $199 


AppSketcher 1.0 
for BeOS 

by BeatWare, Inc. 

AppSketcher is the premier 
programming tool for the BeOS. 

• The fastest way to develop software on the BeOS 

• Drag and drop design is great for creating user interfaces 

• Supports localization for worldwide sales 

• Expands applications easily without manual code 
modifications 

• Shortens development time by automating the Make process 
through direct communication with the BelDE 

(SASFB) Our Price $199 

MacA&D 6.0 

by Excel Software 

• Structured analysis and design 

• Object-oriented analysis and design 

• Real-time and multi-task design 
■ Data and screen modeling 

• Integrated code editing and browsing 

• Multi-user dictionary and requirements 

• Code to design diagrams for C. 

C++.etc. 

• Design diagrams to code for C, 

C++, etc. 

• State modeling diagrams and tables 

• Use cases with traceability 
(SMACADP) Our Price $1995 

Apprentice 6 is a high-quality CD-ROM collection of over 600 
megabytes of up-to-date source code, utilities, and info for Mac 
programmers. All of the source code and utilities are completely 
new or updated tor this release. 

• Frontier 4.1, the highly-acclaimed scripting environment 

• More PowerPlant AND many more PowerPC samples 

• Cool new languages and environments added (Clean, Eiffel, F, 
Tcl-Tk) 

• Hot new demos from leading Mac development companies 
(SAPPRENT6) Our Price $35 
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MacA&D 


Order Toll-free 
800-MACDflM 

WM2-330ii 


Apprentice 6 

by Cetestin Company 




Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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SoftPolish CD-ROM 

by Bare Bones Software 

• The essential tool for software 
quality assurance on the 
Macintosh 

• Helps you identify 
inconsistencies with Apple's user 
interface guidelines, misspelled 
words, missing resources, and 
other mistakes 

• Provides tools to put fie finishing touches on software distribution 
packages prior to release 

• Works independently of any programming language or environment 

• Ideal for sanity checking software throughout the development process 


(SSOFTPOL) Our price $99 


AppMaker 

by Bowers Development 

• Develop the user interface for a 
Macintosh application using the 
original interface builder 

• Just point and click to design 
your application 

• Creates resources and generates 
excellent source code 

• Supports most development 
environments including Metrowerks, Symantec, or MPW; C, 
C++, or Pascal; procedural or object-oriented, using 
PowerPlant, TCL, or MacApp 

• The generated code uses the Universal Headers to provide 
PowerMac compatibility 

• Great tool for beginners to learn object-oriented and 
Macintosh Toolbox programming techniques 

• Includes one-year subscription on CD and hardcopy 
documentation 

(SAPPMAKE) Our Price $299 



B-ltee HELPER 2.2 

by Magreeable Software 

• Inexpensive database engine 
for Macintosh programmers 
in C source code 

■ Uses contiguous fixed length 
blocks 

• Expands the file as necessary and contracts files when 
possible 

• Inserts and deletes keys in one or more 8-Trees 

• Finds keys equal to, less than, or greater than a given value 
in a few hundredths of a second 

• Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 
(SBTREE) Our Price $149 




Future Basic II 

by Staz Software 

FutureBASIC II is the award winning 
leader in Macintosh BASIC 
programming. 

• Source level debugger and Interactive compiler/editor 

• Multi-file Project manager and Multi-file find and replace 

• Super fast compilation, 32 bit clean, and System 7.x sawy 

• QuickBASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard BASIC 


(SFBASIC2) Our Price $229 



• True relational database system for Apple Macintosh computers 

• Provides a powerful choice for developers who want to create 
database centered applications with no performance trade-offs 

• Features SQL, full transaction control, error recovery, single user, 
client server architecture and multi-platform support including 
DOS, Windows, OS/2 and UNIX 

• The C/C++ API is identical and fully portable across all supported 
platforms 

• Third-party vendors supporting dtF will be able to offer a variety of 
advanced features and benefits to their customers royalty free 

• Tools are included for importing, exporting, creating and managing 
databases and users 

• Supported development environments include: Symantec, MPW, 
Metrowerks and more Mac/SDK 

(SDTF) Our Price $695 

Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer "atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder icons into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 
(SINSTALL) Our Price $219 

ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp's InstallerPack, Stufflt decompression, Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) Our Price $169 


8 


] -8OO-MACDEV-1 • Outside U.S. & Canada: 805-494-9797 • Fax: 805-494-9798 


































Water's Edge Software 



Tools Plus libraries + framework 

by Water’s Edge Software 

Easily create compact, fast running, professional looking applications and 
plug-ins*. Tools Plus lets you create virtually any user interface element 
with a single routine, and it transparently provides a robust infrastructure 
to make all your pieces work together as an application. Rated 4 stars by 
Macworld! MacTech (July 96): “it’s an incredibly rich collection of tools... 
If you are Interested in developing applications that have ‘quality’ written 
all over them, then Tools Plus is tor you.” 

• Simplifies programming and thins source code 

• Automates all standard GIJI elements 

• Thousands of extras, from floating palettes and lool bars to 
powerful picture buttons 

• Includes numerous 3D grayscale options 

• Over 1/2 MB of custom fonls, icons, cursors, and other resources 

• Includes SuperCDEFs world-class controls (an $89 value) free 
(STOOLCW) Our Price $249 

CodeWarrior Gold (C/C++ & Pascal, 68K & PPC) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C++ & Pascal, 68K) 

(STOOLSYMT) OurPrice$199 

Symantec (THINK) C/C++ and THINK Pascal (68K) 

(STOOLSYM) Our Price $149 
Symantec (THINK) C/C++ (68K) 

(STOOLPAS) Our Price $149 
THINK Pascal (68K) 

'CodeWarrior required to write plug-ins 


Order Toll-free 

800-MACDIV-l 

(0D6W-3MK 


TestTrack-Bug fracking the Macintosh Way 

by Seapine Software, Inc. 

• Tracks bugs, feature requests, test configurations, users, and more 

• Includes notifications, security, a powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, documentations staff, and project 
managers together to ensure all bugs are identified, fixed, and 
documented 

• Eliminates the need to build custom bug tracking solutions using 
general purpose database tools 

• Supports single- and multi-user bug databases (additional licenses 
required to use multi-user features) 

(STETR) Our Price $129 



CodeBuilder M 'TENON 

by Tenon Intersystems '//> inie bs vstems 

CodeBuilder is a powerful and unique Macintosh software 

development tool for porting existing apps or developing new, 

advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C++, 
Objective-C, Java, Ada, and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C. C++, Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl, MacPerl, tci/tk, bash, sh, 
and esh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 


Phyla™: Object-Oriented 
Database 

by Mainstay 

•Powerful Databases Without 
Programming: Phyla handles your all 
your complex database needs 
•Define a Database in Minutes: Using 
an intuitive, graphical user interface 
•Objects Are a More Natural Approach: 
Phyla creates real world databases 

• Drag-and-Drop Ease: Relate objects by simply dragging objects 
between windows 

• Create Custom Forms and Reports: Quickly create custom forms 
and reports 

• Fast Finds and Sorts: Perform complex queries and calculations 
without programming 

• Synchronize Multiple Databases Copies 

• Password Protection With Access Limitations 

• Easy Import and Export: Import from other databases, export data 
in various formats 

(SPHYLA) Our Price $179 



BBEdit 4,0.4 

by Bare Bones Software 

A powerful, easy-to-learn text 
editor. Adds new features for 
HTML coders, including a 
spelling checker and HTML tag 
palette. Accelerated for Power 
Macintosh; dragging supported everywhere: Internet Conftg 
aware; PowerTalk aware. Integrated support for Symantec's 
IDE, Metrowerks CodeWarrior, THINK Reference 2.x, MPW 
ToolServer, and most other environments. Many UNIX style 
tools, including "grep’’ searches, file comparisons, and sorting 
mufti-file search and replace. PopUpFuncs feature lets you 
jump to a (unction from a menu. 

(SBBEDIT) Our Price $119 




Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 


9 




























TOOLS, LIBRARIES & UTILITIES 



CPU Doubler 

by Orchard Software 

• Performance enhancement utility 
for the Macintosh 

• Increases the speed of your 
computer by 100% 

• Works on both the PowerPC and 
68K Macintosh 

• Manages computer throughput 
using a proprietary scheduling 
algorithm 

• Ensure optimal performance and 

SEE RELATED PRODUCTS: compatibility 

Development Environments (SCPU2X) Our Price $79 


Compiled! 

by Royal Software, Inc. 

Compiielt!, the first HyperTalk compiler, Is a complete developement 
system for the creation of XCMDs and XFCNs. 

• Expand the capabilities of your environment by using Compiielt! 
and the ROM Toolbox extensions 

• Increase the speed of routines written in HyperTalk by turning 
scripts into externals 

• Protect sensalive code from prying eyes because your code is 
now compiled! 

• Easily learn Macintosh programming by exploring the ROM 
Toolbox 

• Includes Debuglt!, a valuable source-level debugger for externals 
created with Compiled! 

(SCOMPIT) Our Price $149 



p CPU Doubler 

-CPU Doubh p 0 

fegOrohard Software, toe ©i 

Doubling Options 

O B«1 Pflrfornwnce 

0 Bsttor PflrfgrtnsfKt 

O Grad Pirformance 
® Custom Pvrformor** 

[ idil Processes,„ ] 

Q&t 

[Help...] 

Hold dpvT> 

□S3 

mi xUrtuf 
Jfcar i 

Special Settings 
[ Include Fites... 1 

O Exclude Background-Onl g 
□ Exclud* Finder 


DesignWorks 4.0 

by Capilano Computing 

DesignWorks 4.0 has all the ease 
ot use and schematic editing 
power of previous versions, plus 
new features designed to make 
your entire design process easier 
and more error free. The 4.0 
version has new menu customization and scripting features that will 
directly address your design checking and interfacing needs. 

• Flexible schematic editing features speed the drawing process 

• Full Undo/Redo on all editing operations 

• Hierarchical design with unlimited levels Is fully supported 

• Powerful attribute features allow arbitrary text information to be 
associated with any signal, device or device pin 

• Extensive symbol libraries with over 12,000 parts in ANSi and 
IEEE format 

• Integrated device symbol editor allows you to create custom 
symbols using standard drawing tools 

• Interactive digital simulator option is available. No netlists, no 
application switching! 

(SDWORKS) Our Price $995 



EtherPeek 

by AG Group, Inc. 

EtherPeek for Macintosh is a full-teatured 
protocol analyzer that allows you to quickly 
and easily test and debug network communication, and: 

• Check tor protocol compliance 

• Use hundreds of built-in decodes 

• Develop custom packet decoders 

• Filter packets during or after capture 

• Test device reactions to specific packet types 

• Customize or alter packets for transmission 

• Generate traffic to test varying loads 
(SEPEEK) Our Price $745 


OpenGL for 
the Macintosh 

by Conix Graphics 

OpenGL is the premier 3D graphics library that allows software 
developers the ability to develop high-quality, interactive 20 and 3D 
graphics applications. OpenGL can perform the following wide range of 
functions which will enhance the development of all graphics software: 

• Geometric primitives (points, lines, and polygons) 

• RGBA or color index mode 

• Viewing and modeling transformations 

• Texture Mapping, Lighting, Shading and Z Buffering 

• Atmospheric Effects (fog, smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing, Accumulation Buffer, Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-uniform rational B-sptines) 

• Feedback, Selection, and Picking Raster primitives (bitmaps and 
pixel rectangles) 

• Pixel Operations (storing, transforming, mapping, zooming) 
(SOPENGL) Our Price $389 


VText 

by Vivistar 

VText is a C++ add-on library for 
Metrowerks' PowerPlant application 
framework. VText provides complete 
Macintosh text support including: greater 
than 32kb text, undo, drag and drop editing, 
AppleEvent scripting and recordability, full 
support for multibyte characters and inline 
input methods including Japanese and Chinese text, and full support 
tor bi -directional script systems including Arabic and Hebrew. 

• Full featured text engine for Metrowerks’ PowerPlant 

• Stylesets and rulersets with labs 

• Flexible object oriented C++ API 

• Full undo and drag and drop editing 

• WorldScript sawy including bidirectional and multibyte scripts with 
inline editing 

• AppleEvent factored for scriptability and recordability 
(SVTEXT) Our Price $349 
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QUED/M 3.0 

by Nisus Software 

• The programmer’s text editor that defined the 
industry standard for speed and efficiency 

• PowerPC native 

• Features integrated support for Symantec 
C/C++, Metrowerks CodeWarrior 6, and MPW 

• Supports all the major development environments on the Macintosh. 

• Powerful editing features, including unlimited undo and redo, macro 
language, scripting, text folding, ten editable/appendabie clipboards, 
markers, displaying text as ASCII codes, dynamic coloring of C/C++ 
keywords/comments, rectangular and non contiguous selection 

• Includes Celestin Company's APPRENTICE 4 
(SQUEDM) Our Price $89 


AG Author 

by Lakewood Software 

AG Author 1.0 is a full-featured Apple Guide authoring tool with 
fully customizable project template. The following features are 
unique to AG Author: 

• Support for styled, colored. & hot text 

• Fully customizable project template 

• Flexible compile options 

• Find & replace tool for scripts 

• Multiple open projects 

• Rapid deployment of project globals 
(SAGA) Our Price $99 

SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman's 
AppleGuide Starter Kit, Real World AppleGuide 





Bee-one 

by Power Box 

Bee-one lightens your load on the road by 
adapting relational databases developed 
under 40° to the Newton Platform. Once 
the program is installed on both the 
Macintosh and the Newton, it takes 4 
simple steps to use Bee-one! 

• Database transfer, Set-up. Use, and Synchronization 
(SBEEONE) Our Price $139 





WAl T 


Web Ware 

by BeachWare, Inc. 

The ultimate collection of clip media and templates 
for building your own Web Page. An incredible 
selection of Shockwave movies, animated GIFs, 
buttons, bullets, dividers, and sample HTML pages. 
There are literally thousands of graphical elements on this disc, all there 
to spice up your web page. In all, it's about 300 megabytes of creativity 
only a mouse-click away! System Requirements; PC - 486 or better with 
8 MB RAM, Sound card, SuperVGA, CD-ROM drive, Macintosh - Color 
Mac with 8 MB RAM, CD-ROM drive. 

(SWEBW) Our Price $24 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Fortran 77 SDK 

SF77 

699.00 

ICONIX PowerToois-10 Pack 

SICPP10 

7,845.00 

ICQNIX PowerToois-6 Pack 

SICPP6 

5,945.00 

ICONIX PowerTools-8 Pack 

SICPP8 

6,945.00 

ICONIX PowerTools-AdaFlow 

SICADA 

1,395.00 

ICONIX PowerTools-ASCII Bridge 

SICASCII 

1,395.00 

ICONIX PowerTools-CoCoPro 

SICCOCO 

1,395.00 

ICONIX PowerTools-DataModeler 

SICDATAMOD 

1,395.00 

ICONIX PowerTools-FastTask 

SICFASTTASK 

1,395.00 

ICONIX PowerTools-FreeFlow 

SICFREEFL 

1,395.00 

ICONIX PowerTools-Object Modeler 

SICOBJMOD 

1,395.00 

ICONIX PowerTools-PowerPDL 

SICPOWER 

1,395.00 

ICONIX PowerTools-QuickChart 

SICQUICKCH 

1,395.00 

ICONIX PowerToois-SmartChart 

SICSMART 

1,395.00 

ICONIX Training & Consulting 

T1C0NIX 

2,945.00 

IMSL Math and Slat Library 

SIMSLSTAT 

495.00 

Info-Mac X 

SINF0MAC10 

39.95 

Ionizer Real-Time Spectral Reshaping Tool 

SIONIZER 

800.00 

LiveAccess™ 1 User Edition 

SLAUE 

69.00 

LiveAccess™ 1 Developer Edition 

SLADE 

99.00 

LiveCard 

SLCARD 

149.00 

LJ Profiler 

SLJPROF 

295.00 

MacFlow'*: Flowchart Design and Development 

SMACFLO 

179.00 

Mac Source II 

SMACSOURCE 

29.95 

Nisus Writer 5.0 

SNISUSW 

220.00 

Plan & Track™: Project Planning and Management SPLNTRK 

179.00 

Screen Machine 

SSM 

24.00 

Spyer 

SSPY 

39.00 

Visual Cafri 

SVCAFEMAC 

199.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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WebTen 

by Tenon 
Intersystems 

WebTen is an 
industrial-strength, 
high-performance 
Apache Web server for 
Power Macs. WebTen's 
Web-based browser 
interface enables local 
or remote administration via your favorite browser, Since Apple's NeXT 
acquistion, Tenon has extended their unique “UNIX virtual machine" 
technology to produce a set of “Rhapsody-Ready" internet 
applications, WebTen is the first offering in this series, 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon's multi-threaded, pre-emptive 
multitasking environment 

• Tenon's unique technology supports the widely acclaimed Apache 
Web server as a double-clickable Macintosh application 


(SWEBTEN) Our Price $495 


OOFILE Reporter Writer 

by A.D. Software 

• Full embedded report-writer, allows you to preview page-by-page 
and either print or save as plain text, HTML or RTF 

• Multiple levels of breaks, database views, headers and footers are 
provided using a clean object-oriented design 

• Incudes RAM-based version of OOFILE database. Included in full 
OOFILE Platform Bundle 

• Saving to file without preview of printing is cross-platform-run on 
your Mac/Win/Unix server and creates web pages 

• Price includes 1-year subscription 
(SOORW) Our Price $499 



ne wA*odUCT! 
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WebSiphon 

by Purity Software, Inc. 

WebSiphon is one of the most 
anticipated new CGI products for 
Macintosh Webmasters delivering a 
complete authoring tool for truly 
revolutionary sites. This product 
alone can replace most all CGIs on 
your site resulting in increased dynamic serving speed, 
reliability, and powerful scripting and database abilities directly 
within your HTML pages! Also includes Verona, the fastest flat- 
file database server available for Macintosh web sites, 
(SWSIPHON) Our Price $495 



PageCharmer: Sizzling Effects... 



PageCharmer 1.0 

by Mainstay 

PageCharmer is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code, 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need. 

FEATURES; 

LiveG-Map, LiveT-Map, LiveG-Button, LiveT-Button, LiveGT-Button, 
LiveG-Ticker, LiveT-Ticker, LiveG-Marquee, and LiveT-Marquee. 
(SPGCHRM) Our Price $139 


BBEdit 4.0.4 

by Bare Bones 
Software 

A powerful, easy-to- 
learn text editor. Adds 
new features for HTML 
coders, including a 
spelling checker and 
HTML tag palette. 
Accelerated for Power Macintosh; dragging supported 
everywhere; Internet Config aware; PowerTalk aware, 
integrated support for Symantec’s IDE, Metrowerks 
CodeWarrior, THINK Reference 2.x, MPW TooiServer, and most 
other environments, Many UNIX style tools, including "grep" 
searches, tile comparisons, and sorting multi-file search and 
replace. PopUpFuncs feature lets you jump to a function from 
a menu. 

(SBBEDIT) Our Price $119 



ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-mail products 

• Royalty-free MIME, SMTP, and POP3 APIs 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 
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800-MACDEV'l 
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Roaster 

by Roaster Technologies, Inc. 

Roaster Release 3.1 is now available with JDK 1.1 and JavaBean 

support! Get the most out ol Sun’s Java rM programming language 

with this powerful development environment. 

• Features include: ability to build stand-alone Macintosh 
applications or applets; visual interface builder; ability to create 
cross-platform zip files; powerful Java debugger; wizard for quickly 
creating Java applets or applications; JavaBean support; JDBC 
support; Java object database included; ability to call AppleScripts 
from Java; Just-in-time (JIT) compiler; JDK 1.1.x support; class 
tree and hierarchical class browser; much more! 

• Software includes: Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design's PSE for 
Java; OpenLink Software’s JDBC Drivers; OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3.0; much more! 

• Requirements: Runs on 68k or PowerPC, CD-ROM 

• Price includes ail web-based updates 
(SROAST3) Our Price $99 



Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

BSD4.4 and the Mach kernel, MachTen brings the power 

of Unix to your desktop at an extremely attractive price point. 

MachTen enables you to: 

• Run a high speed internet server, complete with WWW, FTP, NFS, 
DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications in a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada, C, C++, Pascal, Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run Sottware.com Inc's acclaimed Post-Office mail transport service 
(SM10PPC) Our Price $695 


Web site: http://www.devdepot.com • 
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Rumpus 

by Maxum Development 

Maxum’s new, high- 
performance FTP server for 
the MacOS. Based on 

Maxum’s RushHour TCP/IP implementation, Rumpus 1.0.1 offers 

the performance and reliability of high-end workstations with the 

ease of use, security, and flexibility of the Macintosh. 

■ Simplified setup, with no need to configure AppleShare, File 
Sharing, or Users & Groups for simple anonymous FTP 

• Anonymous and/or secure server access, with separate 
security settings for anonymous vs. secure users 

• Automatic MacBinary and Binhex encoding 

• Complete logging, with separate anonymous and secure 
access logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) Our Price $195 


ScriptDemon 

by Royal Software, Inc. 

ScriptDemon is a browser plug-in that, for the first time, allows you to 
deliver and run AppleScripts from Web pages. The ScriptDemon plug¬ 
in will execute the embedded AppleScript code included on a Web 
page. ScriptDemon painlessly and inexpensively bandies many 
previously impossible tasks, such as: 

• Using the Intranet to manage all Macintosh computers on-line 

• Using the Internet to install and configure software 

• Using the Internet to configure hardware 

• Delivering complex sets of files and assembling them on the 
browsing computer 

• Providing interactive education and product support on both the 
internet and Intranet 

• A perfect companion to UveCard! 

(SSDEMON) Our Price $949 


CGi Toolkit 

by Pictorius Inc, 

The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs 
and ACGIs for your Mac Web site. 

• interactively develop CGIs while the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

• Interactively develop, test and debug CGIs before compiling 

■ Powerful debugger allows you to edit code, roil back, code and 
change input values while your application is running 

• Fully object oriented so you can re-use your code 

• Automatic handling of Apple Events so you can concentrate on 
building functionality 

• Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 
(SCGfTLKT) Our Price $149 

E-mail: orders@devdepot.com 
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FaceSpan v2.1 

by Digital Technology International 

• Develop integrated software, make stand 
alone applications, create friendly 
interfaces 

• Develop quick prototypes, print multiple 
pages with sophisticated layouts 

•Script essential elements of the FaceSpan 
application - Enhanced save options 

• Play and record sounds as either "snd” resources or as “AIFF” files 

• Create miniature or complete apps that run on either Power PC or 
68k computers 

• Use precise time measurement for implementing timed behaviors 
— New properties 

• Proportionally scale PICT images -Align images in a pictbox - 
Automate any application 

• Monitor and respond to low-memory situations-Increased support 
for Frontier UserTalk! 

(SFACESPAN) Our Price $299 




PreFab Player 

by PreFab Software, Inc. 

PreFab Player is a faceless background application (similar to a 
system extension) that lets your scripts query and control otherwise 
non-scriptable applications, desk accessories and control panels. 
Player adds verbs that directly manipulate the Macintosh user 
interface; choose from menus & pop-ups, select radio buttons, type 
text, determine the name of the frontmost window, the state of a 
check box, etc. Balloon help identifies non-standard dialog items. 

• Adds verbs to AppleScript and to Frontiers UserTalk 

• Controls the Frontmost Application 

• Balloons Identify User Interface Objects 
(SPLAYER) Our Price $95 


Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, there's 
only one serious choice. Scripteri 
• Scripter and FaceSpan work together; one 
click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call Box 

• Applet simulation, live editing, Object map, associated terminology 

• Search backwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

• Now Includes ScriptBase; stores your data and media elements 
and share them between scripts all with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 



AppleScript Software 
Development Toolkit 1.1 

by Apple Computer, Inc. 

• AppleScript language, system software 
extension, and script editor 

• FaceSpan 1.0 

• Developer’s redistribution license for 
AppleScript System software extension 
and FaceSpan runtime code 

(SASDT) Our Price $49 



Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most tram 
AppleScript! 

• Advanced debugging environment offers 
singfe-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphical view of objects provided by scriptable 
applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) Our Price $129 



TCP/IP Scripting Addition 

by Mango Tree Software 

•Award-winning AppleScript scripting 
addition 

•Allows you to write scripts using 
MacTCP™ commands in AppleScript ,M 
•Send e-mail or files through a script, 
check if users are logged on (via Finger), automate FTP, Gopher, 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCP/IP client-server programs 
• Works with AppleScript, MacTCP 2,0.4 and Open Transport 
(STOP) Our Price $49 


WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using HyperCard. Design Real "Macintosh” user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard stacks or Macintosh applications. With WindowScript 
you can literally bring the look and feel of a real Macintosh user- 
interface to HyperCard. If you're a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping tool, WindowScript is perfect for the job. 
(SWSCRIPT) Our Price $149 
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Apple Media Tool Programming Environment 2.1 Multimedia Authoring with Apple Media Tool 

by Apple Computer, Inc. by Apple Computer, Inc. 


• This object-oriented language and application framework allows 
programmers to customize features used within the Apple Media 
Tool authoring environment 

• Includes an expanded Apple Media Language (AML) class library, 
incremental compiling and linking of AML code, faster debugging 
facilities. Macintosh Programmers’ Workshop (MPW). and user-oriented 
documentation written from an AMTPE developer's perspective 

• Portable across 68K. Power Macintosh, and Windows platforms 
(SAMTPE) Our Price $995 


Apple Media Tool offers new multimedia users a way to get started 
creating interactive multimedia with minimal learning time. This self- 
paced tutorial will make Apple Media Tool (AMT) even easier to 
understand and to use. Using this tutorial, you will create a realistic 
multimedia project using exciting techniques such as QuickTime 
movies, animation and more. A demo version of AMT is included and 
can be used for the exercises. Training Format: Tutorial with labs. 
(SMWAMT) Our Price $49.95 



Virtual Reality 

Programming 

with QuickTime VR 2.0 

by Apple Computer, Inc. 

• Virtual Reality Programming Book/CD-ROM 
for QuickTime VR 2.0 

• Enables you to write C and C++ programs 
using QuickTime VR 2.0 

• Allows QuickTime VR to be used in 
games, multimedia titles and other 
programs 

• QuickTime VR 2.0 objects can be zoomed 
in on, panned, or linked with hots spots 

• Both panoramas and objects have hot 
spots linked to World Wide Web URLs 
(SVRPQT) Our Price $49 


QuickTime Developer’s Kit 2.0 

by Apple Computer, Inc. 

• QuickTime 2.0 Extension, QuickTime Power 
Macintosh Extension, and QuickTime 
Musical Instruments extension 

• Utilities like MoviePlayer 2.0,16-bit Audio 
Compression, etc. 

• Sample content such as MPEG Movies, 
Music Movies, Time-Code Movies, and 60 
field per second movies 

• Includes software-only playback features 
such as faster 2x playback mode for 
current compressors. Apple Cinepak 
compressor, 1 -bit fast dithering, network 
tuning. load-into-RAM option, and Photo 
CD support 

(SQTDK) Our Price $99 



by eVox Productions 

Clip VR" is a new digital image library 
offering high quality Photographic Virtual 
Reality (PVR) images for use with Quicklime" 
VR and other desktop VR tools. 

Clip VR’" Panoramic Image components include 
alpha channel masks. Combine elements into a 
composite panorama which is converted to the 
finished QuickTime VR movie using Make QTVR 
Panorama Tool. The Components (“Clips") 
include complete 360 degree scenes, 
libraries of 360 degree terrains, 360 degree 
skies, buildings, and objects. Images are 
provided as .PICT files AND QuickTime VR 
movie tiles. Clip VR™ allows you to create 
high quality VR worlds from pre- 
photographed component images. Clip VR™ 
can be used to add excitement to a web site, 
to increase the interactive value of a CD- 
ROM, or simply for fun! Requires imaging 
editing program such as Adobe Photoshop “ 
to perform .PICT image compositing. 
(SCLIPVR) Our Price $89.95 
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QuickTime VR 2.0 
Authoring Tools Suite 

by Apple Computer, Inc. 

• QuickTime VR is a cross-platform software 
from Apple which enables webpage 
designers and professional developers to 
create new multimedia products and 
webpages incorporating QuickTime VR 
content. With QuickTime VR. users 
Interactively navigate through 360° views 
of space, and explore three dimensional 
objects on Macintosh or Windows-based 
personal computers 

• The QuickTime VR Authoring Tools Suite is 
a set of Macintosh tools to create and link 
panoramas and objects from 


photographic, digital, video, or computer 
generated images 

• included is a complete set of 
documentation for planning, designing, 
photographing, and creating QuickTme VR 
panoramas and objects. The authoring 
tools also allow you to link objects to 
panoramas using clickable hot spots 

Included on the CDs are: 

• A software tool (MPW-based) that stitches 
and blends adjacent images into a 
panoramic PICT file 

• A software tool (MPW-based) that dices 
and compresses panoramic PICT files to 
less than 100 KB (low resolution) per 
panorama 


• A scene editor (HyperCard-based) to 
create QuickTime VR scenes by adding 
and positioning nodes, hot spots, linking 
nodes together, and tor linking QuickTme 
VR objects to scenes 

• A variety of utility tools for formatting the 
data into the runtime software 

Due to a revolutionary distortion-correcting 
algorithm, QuickTme VR panoramas and 
objects maintain a normal perspective when 
the user moves the mouse. The speed of the 
algorithm allows up to 24-bit color images. 
Both vertical and horizontal panning can 
occur at fast speeds. 

(SQTVRATS) Our Price $395 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Terran Interactive 


Media Cleaner Pro 

by Terran Interactive 
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Use Media Cleaner Pro 2,0 to optimize and compress video for 
CD-ROM, kiosk, or the Internet, Media Cleaner Pro automates 
your work flow allowing you to get the highest quality video, 
faster and easier than any other program on the market. 

• Includes Adobe Premiere Export module 

• Optimai palette generation, Drag-and-drop batch processing 

• RealMedia, VDOLive and improved QuickTime support 

• Dynamic Preview Window, the Media Wizard, multiprocessor 
support and more! 


Captivate 4.6: 

Essential Graphics Utilities 

by Mainstay 

Captivate™ 4,6 is a powerful collection of 
graphics utilities for Macintosh, based on 
Mainstay’s acclaimed screen capture utility, 
graphics and multimedia scrapbook, and 
graphics viewer. Captivate provides essential graphics utilities to the 
professional and hobbyist alike, 

• Package includes: Captivate Select, Captivate View, and Captivate Store 

• Any one of the three can be used alone, and together they make 
an unbeatable team 

• Whether writing a training manual, creating an ad, or just creating 
a startup screen from your favorite picture, Captivate is everything 
professionals need at a price anyone can afford. 

(SCAPTIV) Our Price $79 



System Requirements: 

68040 Mac or better (PowerPC strongly recommended, req'd for 
RealMedia), QuickTime 2.0 or later (2.5 strongly recommended) 

8 Mb application RAM, MacOS 7,0.1 (7.5 or later recommended) 
SoundManager 3.2, CD-ROM Drive 
(SMCP) Our Price $359 

Registered owners of Movie Cleaner Pro 1,3 or earlier can upgrade 

$129 


Music Tracks 

by BeachWare, Inc. 

A new PC/Mac & Audio multimedia music CD-ROM, The clips include 
musical introductions, fanfares, background music, and more. This 
collection offers you 100 music clips stored in .WAV format for 
Windows, SoundEdit & AIFF formats for Macintosh and as Audio 
tracks for audio CS players. All of the music clips are completely 
license and royalty-free!! Mac System requirements: Mac Plus or greater, CD-ROM drive. PC 
system requirements: Windows 3.1 or later, Sound Blaster compatible board, CD-ROM drive. 

(SMT) Our Price $24 

Order Toll-free 
800-MACDEV-l 

( 800022-33811 
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Multi Ware 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music CD-ROM for the 
Macintosh. This disc is a collection of clips ideal for Desktop 
Presentations and other Multimedia applications. This incredible 
collection of license-free media clips is bursting with 240+ color pictures and backdrops (PICT), 
200+ sound & music clips (SoundEdit), 140+ QuickTime movies, and a variety of multimedia 
tools for use with the Macintosh. 

(SMWMC) Our Price $24 


AudioTtack 

by WAVES 

AudioTrack is a 
software plug-in for 
native processing on 
digital audio 
recording and editing 
systems. Waves 
AudioTrack combines the most-needed audio 
processors into a single piece of software, 
including 4 bands of equalization, 
compression/expansion, and noise gating. 
AudioTrack is ideal for preparing audio for 
InterNet streaming formats, processing 
individual mono/stereo tracks of audio and 
audio for video editing systems including 
digital sequencers. 

Feature list 

• A single window interface 

• 4-band ParaGraphs Equalizer, 
Compressor/Expander and Gate 

• instantaneous A/B comparisons of on-line 
settings 

• Pretested setup libraries supplied for 
various processing solutions 

• Power Macintosh native processing 
(requiring no DSP board) 

• Volume and gain reduction meters 

• Peak hold and ciip meters 

Requirements: 

The AudioTrack is compatible with all 
machines supported by Deck II, SoundEdit 16, 
Adobe Premiere 4.0 and Cubase VST 3.1 
(SAUDIOTRK) Our Price $270 
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Casino! 

by (teachware, Inc. 

Can’t make it to Vegas this month? Your 
best bet is Casino! Whether your favorite is 
Slots, Poker. Blackjack, or Keno, this virtual 
casino will entertain you for hours with its 
ten different machines. Mac System 
requirements: Color Mac, CD-ROM drive, 4 MB of RAM. PC system 
requirements: Windows 3.1 or later, CD-ROM drive, 4 MB of RAM. 
(SCAS) Our Price $24 
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Abuse 

by Bungie Software 

Abuse is 360 degrees of side-scrolling action. 

Run, jump, fall and fly in any direction - through 
industrial corridors, caverns and sewers. Destroy 
enemies in any direction with grenade launchers, 
rocket launchers, napalm and nova spheres! Avoid 
deadly traps with jet packs and turbo boost! 

Key Features: 

• Make your own mayhem with the Level Editor 

• Hunt down your friends in 8-person multiplayer games 

• Awesome Arsenal. Napalm Bombs, Nova Spheres and the Death Saber: 
just a few ways to lay waste! 

• Point and Kill Interface. Move and annihilate mutants in complete 360° freedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scrolling action. Run, jump, fall and fly in 
any direction - through industrial corridors, caverns and sewers 

• Destroy enemies in any direction with grenade launchers, rocket 
launchers, napalm and nova spheres! Avoid deadly traps with jet packs 
and turbo boost! 

(SABUSE) Our Price $51 



1000 Games for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in the 
entire world, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart mn-away asteroids, deal yourself that royal flush or 
solve that 3-D puzzle, this disc has it all! System requirements: Mac 
Plus or greater, CD-ROM drive, and 2 MB ot available RAM (4 MB ol 
RAM when running under System 7). 

(STGM) Our Price $24 



Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, 
redone with killer graphics and sounds! Walk 
through a virtual arcade and test your game 
playing skills with these exciting arcade 
classics. Ten games, including Moon Lander, 
Astro-Boing, Hyper Hockey, Ballistic Avenger, and more. System 
Requirements: Mac - Color Mac with 8 MB RAM. CD-ROM drive. PC 
486 with 8 MB RAM, Sound card, SuperVGA,CD-ROM drive. 

(SCLA) Our Price $24 
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Marathon Trilogy Box Set 

by Bungie Software 

The Marathon Trilogy Box Set brings ail three 
Marathon games together in one affordable package, 
with tons of extras thrown in. Besides Marathon, 
Marathon 2: Durandal and Marathon infinity, you'll 
also receive a staggering 1200 maps, featuring 
never-released Bungie maps and the winners of the 
Infinity Mapmaking Contest, The Marathon Scrapbook 
(a behind-the-scenes look at themaking of the Marathon games), Marathon 
collectables like tie Marathon 3-sticker set, and to top it oft, the award¬ 
winning game that laid the groundwork for Marathon: Bungle’s breakthrough 
Pathways Into Darkness. 

The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics acceleration of 630 and 6200 machines, is 8,16 and 24-bit color 
capable, arid can be played with joysticks and game pads. The package 
requires a 68040 or higher Macintosh,CD-ROM drive, 8-bit color monitor 
(13” recommended), and System 7 or later. 

(SMTBS) Our Price $65 


Trivia Warehouse 2000 

by BeachWare, Inc. 

Introducing a fun new PC and Mac CD- 
ROM. This disc contains two thousand 
trivia questions, in 45 categories, in 
several game formats! Test your memory 
with the Q&A, Concentration, and Multiple 
Choice games! Categories include: 
Animals, Bodies, Bond, Bugs. Cities, Comics, Geography, Gilligan, 
Gross, Health. Holidays, Horrors, Kids. Knot's Landing, Math. Movies, 
and many more. Mac System requirements: Color Mac, CD-ROM 
drive, 4 MB of RAM. PC system requirements: Windows 3.1 or later, 
CD-ROM drive, 4 MB of RAM. 

(STW2K) Our Price $24 




Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

A Zillion Sounds SAZS 24.00 

Night Sky Interactive SNSI 24.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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System 7.5 Technologies 

by Apple Computer, Inc. 

• Self-paced course designed to allow 
software developers to write code that 
extends the functionality of an application 
for System 7,5 

• Contains comprehensive materials for drag-and-drop, threads, 
standard mail package, and QuickDraw GX printing 

Students should be familiar with the basics of developing an 
application on the Macintosh. Metrowerks CodeWarrior Lite is 
included on the CD with the lab exercises. The lab assignments were 
developed in CodeWarrior 8. The labs can also be done in another 
development environment but project files for them are not provided. 

Training Format: Tutorial with labs. 

Requirements: Macintosh or Mac-OS compatible computer with a 
68020 processor or greater (PowerPC preferred); 8 MB RAM; 25 
MB hard disk space; System 7.5 or later; CD-ROM drive. 


Apple Guide Integration 

by Apple Computer, Inc. 

• Self-paced overview teaches you when and 
how to add Apple Guide help to your program 

• Powerful help system that can guide the 
user through a task. 

• Tutorial will lead you through the steps necessary to integrate 
Apple Guide into your application. CodeWarrior Lite is included on 
the CD with the lab exercises. 

Training Format: Overview with labs. 

Requirements: Macintosh or Mac-OS compatible computer with 
68020 processor or greater, PowerPC preferred; 8 MB RAM; 25 MB 
hard disk; System 7.5 or later; CD ROM drive. 

(SAGI) Our Price $49.95 




(SSYSTECH) Our Price $49.95 

Virtual TUtor for QuickTime VR 


Q £ 


by Apple Computer, Inc. 

• Self-paced, hands-on course, which 
provides a comprehensive environment for 
learning the steps of the QTVR 
development process. The student can 
cover all of the topics or choose areas to 
focus on. Topics covered include: QTVR 
capabilities and key concepts, panoramic 
movies, object movies. QTVR Scene 
movies and authoring with QTVR 

• CD-ROM contains tots of useful examples 
and demos. In addition to all the step-by- 
step exercise files 


If the student completes the entire course, 
he/she will create a complete, authored 
multimedia project similar to the 
demonstration title that comes on the 
enclosed CD-ROM. There are approximately 
3-4 days of training. 

Training Format: Tutorial with labs. 

Requirements: 40 MB RAM minimum, 64 
MB preferred; Macintosh or Mac OS- 
compatible computer with a 33 MHz 68040 
processoror greater; System 7.1 or later; 
CD-ROM drive; 17" color monitor. 
(SVTTQTVR) Our Price $79.95 



Apple’s develop™ 
back issues are 
available for only 
$10 per copy. 

To place your 
orders, call 

800/MACDEV-1 . 



frit Vafiaiinh 

Ptor mnwrn & fJvfdViywfi 



MAGAZINE 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with 
everything they need to know about software development. Topics 
like Rhapsody, Java, QuickTime, OPENSTEP, Objective-C, C/C++. 
Object Oriented Technologies, product reviews and much more! 
Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) International for 12 issues $97 

Back Issues: each plus shipping (subject to availability) $10 
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metrowerks 


CodeWarrior Wear 

You live it, you breath it... you 
might as well wear it! (XL only) 



Alien T-Shirt 

(AALIEN) Our Price $9.95 
Arnold T-Shirt 

(ACWARNLD) Our Price $9.95 

Arnold Jr. T-Shirt 

(AARNOLDJR) Our Price $9.95 

Blood, Sweat & Code T-Shirt (SS) 

(ACWSBLOOD) Our Price $9.95 

Blood, Sweat & Code T-Shirt (LS) 

(ACWLB100D) Our Price $14.95 

CodeWarrior Baseball Cap - Black 

(ACWBHAT) Our Price $14.95 

CodeWarrior Sweatshirt - Black 

(ACWSWEAT) Our Price $29.95 

CodeWarrior Hawaii Five-0 Shirt 

(ACWHAWAII) Our Price $9.95 

CodeWarrior Winter Hat 

(AWINHAT) Our Price $14.95 

Debugger Boxer Shorts 

(AOBOXER) Our Price $16.95 

Discover Programming T-Shirt 

(ADiSCPI) Our Price $9.95 




Podeum Sport 

by Rach, Inc. 


Now you can have laptop stability, drop 
protection & mobility, If you're looking 
for an inexpensive, non-technical gift 
for a laptop owner - look no further. 

• Strap your laptop to your leg 

• Universal size - fits all laptops and 
all legs (13"-46") 

• Velcro Velcoins attach your laptop to the podeum 

• Podeum allows working angles up to 90 degrees 
Dropped laptops account for 41% of all laptop fatalities 
Manufacturer's lifetime warranty. 

(APODSP) Our Price $39 



MacTech® Mouse Pad 

Slide on this! With an extra-large surface (11" by 10") and 
a deluxe sleek plastic coating, you’ll be zooming across 
your screen in no time at all. Speed limit not enforced! 
(AMTPAD) Our Price $8.95 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Getting Started With WebObjects 

by NeXT Software, Inc. 

if you're a first time user, start here to learn the basics of how to 
create and run WebObjects applications. 

(BGSWO) Our Price $14 

WebObjects Developer's Guide 

by NeXT Software, Inc. 

A guide to building and understanding WebObjects applications, 
Takes a close look at the WebObjects scripting language. Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Filled with 
example code. For all WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Developer’s Guide 

by NeXT Software, Inc. 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-world examples, the book steps you through the 
process of making your OpenStep objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 

Discovering OPENSTEP, Mac 

by NeXT Software, Inc. 

Introduces programmers to NeXT's OPENSTEP 4.0 Developer product 
by guiding them through the creation of three applications ot 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C fundamentals, common APIs, 
and usage of the developement tools. Along the way they present 
summaries of important concepts and paradigms. The book also 
includes a chapter directing readers to programming resources, 
further information, and services such as training and support. An 
appendix offers a concise discussion of object-oriented programming. 
(BDOSTEPM) Our Price $15 

Discovering OPENSTEP, Windows 

by NeXT Software, Inc. 

Discovering OPENSTEP provides an introduction to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Along the way, 
it explains concepts and illustrates aspects of Objective-C, OpenStep 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) Our Price $16 



Object-Oriented 
Programming and Objective C 


by NeXT Software, Inc. 

An introduction to the principles of object-oriented programming in 
OPENSTEP and the official description ot the Objective-C language. 
Objective-C is easy to learn and use because It adds very little 
syntax to the C programming language. It's dynamic nature allows 
you to accomplish things not possible in most other object-oriented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Working w/ Interface Builder (for eof) 

by NeXT Software, Inc. 

A hands-on, award-winning book designed to help you get your job 
done with the updated Interface Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using interface Builder to design objects that truly work in 
NEXTSTEP. 

(BWIB) Our Price $24 

Using EOF 2.1 w/ OPENSTEP (Mac & Windows) 

by NeXT Software, Inc. 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework application on 
OPENSTEP, It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework application. 
(BUEOFO) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mac & Windows) 

by NeXT Software, Inc. 

The Enterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Framework tools and classes. II includes an architectural overview of 
the product, and descriptions of programming tips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling. 
(BEOFDG) Our Price $24 

EOF Developer's Guide for EOF 2.0 (BEOFDG20) Our Price $24 
EOF Developer's Guide for EOF t .x (BE0FDG1X) Our Price $24 
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Increasing Hits and 
Selling More on your 
Web Site 

by Greg Helmstetter 

Written especially for entrepreneurs, 
corporate marketing managers, small 
business owners, and consultants, this 
valuable guide gives you rare tips and 
tricks you need to know to make your 
site a commercial success. 

(BiHSMWS) Our Price $ 22.45 

Measuring the Impact of 
Your Web Site 

by Robert W. Buchanan and 
Charles Lukaszewski 

This book features case studies from 
many successful and some less 
successful corporate web site pioneers. 
You will learn techniques and 
commercially available tools tor 
measuring site traffic and visitor behavior -and help you choose the 
right ones for the job. Written by leading corporate site consultants this 
book tells you how to develop a management strategy geared toward 
optimizing web site productivity. 

(BM1YWS) Our Price $ 26.95 
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The Way Computer 
Graphics Works 

by Olin Lathrop 

A complete guide to mastering 
computer graphic basics. It is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles of animation. 
All of this is done without resorting to mind-numbing equations and 
impenetrable technical jargon. 

{BWCGWj Our Price $29.65 

Debugging Macintosh 


the way w 
computer 
^graphics 
works 4^ 



gging Macintosh 
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Software 
with MacsBug 

by Konstantin Othmer and 





tftN ST A S" T 1 N tn HMEfc 
JIM srttAtis 


Jim Straus 

MacsBug, from Apple Computer, Inc., 
is the leading debugging software 
program tor the Macintosh. This 
book/disk package is an all-in-one kit 
for using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents of the resl of the book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31.45 



place on 
(BTISP) 



The Internet 
Strategic Plan 

by Martin A. Schulman and 
Rick Smith 

This book gives you all ot the 
management tools you need for 
creating a strong Internet and Web 
presence. A blueprint lor your strategic 
plan, this book guides you every step of 
the way in establishing your company's 
the Internet and World Wide Web. 

Our Price $ 22.45 


The Web Navigator 

by Paul Glister 

This book keeps you right on top of all 
the recent changes in the Web, tells 
you whal’s oul there right now and 
what's coming in the future. You’ll gel 
samples of various Internet sites and 
candid discussions of providers. You’ll 
receive proven strategies for finding 
and managing information. 

(BTWN) Our Price $ 22.45 


JavaScript 
Cookbook 

by Yosef Cohen 

Everything you need to master the 
fundamentals of JavaScript 
programming is in this book/CD-ROM 
package. A special easy-to-use 
reference section offers detailed 
analysis and examples of objects, 
properties, event handlers, and 

statements. You'll also find all the latest information relevant to 
JavaScript programming since the advent ot Navigator 2.0. 
(BJSCB) Our Price $44.99 


HTML Sourcebook, 3rd 
Edition 

by Ian S. Graham 

Critics everywhere agree, HTML 
Sourcebook is the best guide to HTML 
tor Web professionals. Thai's because 
no other book makes it so easy for you 
to quickly master all the commands, 
tools, and expert techniques you need 
to create cutting-edge Web page 

documents. Completely revised and expanded by nearly 50 percent, 
this new third edition of the best-selling guide to HTML gives you the 
complete iowdown on all the changes and enhancements to the 
HTML, HTTP, and URL standards. 

(BHTMLS) Our Price $26.95 


JavaScript 
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Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Designing 3D Graphics 

by Josh White 

In this powerful book/CD- 
ROM package, top 
computer graphics artist 
Josh White tells you 
everything you need to 
know to create sophisticated real-time 
3D graphics for computer games and 
virtual reality. This book contains the in- 
depth knowledge of software tools and hands-on modeling 
techniques that Josh White has learned while creating artwork for 
over 20 commercial games, including Descent, Zone Raiders, Locus, 
Legoland, and others. 

(BD3DG) Our Price $35.95 
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Web Marketing 
Cookbook 

by Janice M. King, Paul Knight, and 
James H. Mason 
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Create the ultimate Web 
marketing site, quickly 
and painlessly! Learn how , 
to build a Web site for 6 -To^ 
your small business or nonprofit 
organization with this step-by-step 
approach. This book/CD-ROM package contains your simple, non¬ 
technical tools for converting your print brochures, text, and graphics 
into a powerful online promotion. 

(BWMCB) Our Price $35.95 


CGI 
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Developing CGI 
Applications with Perl 

by John Deep and Peter Holfelder 

A complete step-by-step guide to 
creating sophisticated interactive CGI 
applications using Peri. 1! you're ready 
to buifd your own customized 
interactive documents, forms, graphics, 
and other full-feature CGI applications 
using Perl, then this book will show you 
how. Covers CGI, HTTP, and the Perl scripting language. 

(BDCG1A) Our Price $26.95 
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Rhapsody DeveloperOS Guide 

by Jesse Feiler 

Covers the basic architectural principles of Rhapsody; the Mach 
microkernel, object-oriented programming, and the elements of a 
modern OS such as preemptive multitasking, protected memory, and 
symmetric multiprocessing. Also shows ways of getting to this new 
environment—Objective C, conversion tools, and the integration of 
Java—to develop Rhapsody products. Paperback, 450 pages, 
(BRDG) Our Price $35.95 


Check out our Web site! 

* Full product descriptions * Hundreds of more products 

http://www.devdepot.com 


Practical Object- 
Oriented Development 
in C++ and Java 

by Cay S. Horstmann 

This book offers advice on real-world 
ways to use these powerful 
programming languages and 
techniques. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Horstmann gives you clear, concise explanations of object- 
oriented design, C++, and Java in a way that makes these potentially 
daunting operations more accessible than they've ever been before. 
(BPOOD) Our Price $31.50 

WebMaster in a Nutshell, Deluxe Edition 

by O'Reilly & Associates, Inc. 

Cross-platform, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster’s toolbox. The CD-ROM contains the Web 
Developer’s Libaray—the fuil text of the latest editions 
of five popular O'Reilly titles; "HTML; The Definitive 
Guide, 2nd Edition"; "JavaScript; The Definitive Guide, 2nd Edition"; 
"CGI Programming on the World Wide Web"; "Programming Perl, 

2nd Edition"; and "WebMaster in a Nutshell." The Deluxe Edition 
also includes a printed copy of "WebMaster in a Nutshell," the alt- 
inclusive quick reference that belongs next to every webmaster's 
terminal, Includes CD-ROM & 356 page book. 

Requirements: The CD-ROM is readable on ail platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript. 
(BWMNUTD) Our Price $62.95 
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Programming For The 
Newton Using 
Macintosh, 2nd Edition 

by Julie McKeehan and Neil Rhodes 

This book gives you 
everything you need to 
create Newton 2.0 
applications, From the 
people who developed the 
Newton programming training materials for Apple Computer, this 
book uses a clear and comprehensive approach to teach you how to 
program the Newton. Includes a CD-ROM full ol sample code and 
additional goodies. The samples include solutions to all of the coding 
examples found in this book. Each example and exercise also has a 
narrated QuickTime movie showing the solution from start to finish 
in Newton Toolkit. 

(BPFNUM2) Our Price $31.45 
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Wireless For 
The Newton 




by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming for the Newton left off, 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as well as a fully functional 
demonstration version of Newton Toolkit. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
as well as demonstration NTK - the complete development 
environment for hie Newton 

(BWIRELESS) Our Price $31.45 
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JavaScript 
& Netscape Wizardry 

by Oan Shafer 

The perfect book to show you how to 
turn Netscape into your 
own personal, 
customized operating 





system. Provides the 
inside tips and 
techniques for making your Web 

pages much more attractive. Shows you how to use all of the key 
features of the JavaScript language, including objects, methods, 
properties, events, and much more. Includes CD-ROM with 
numerous interactive scripts written in JavaScript you can add to 
your Web pages today. A complete set of the best Java applets. 
Useful plug-ins designed to supercharge Netscape and resources to 
help JavaScript programmers, 

(BJNWIZ) Our Price $31.45 


JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 

Written by developers for 
developers. An advanced v-ir ' st 
guide to creating 
professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft Internet 
Explorer 3.0, and IJveWire. Includes CD-ROM with Sun’s Java 
Developer's Kit, JavaScript and HTML Editors for Windows and 
Macintosh, 20 contributed ready-to-run JavaScripts and JavaScript 
examples from the book. 

(BJSDG) Our Price $44.99 




Web Graphics 
Tools and 
Techniques 
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Web Graphics Tools 
and Techniques 

by Peter Kentie 

The ultimate source of information on 
Web graphics tor both Macintosh and 
PC users. Recent technologies covered 
include: ActiveX, Sound. Adobe Acrobat, 
Java, VRML, QuickTime VR and video, 
Shockwave, and 3D Animation. 

(BWGTT) Our Price $35.95 




Guidelines for how 
tooplace information online 
within your company. 

Provides both a design and 
development process and 
a set of guidelines for the Internet, 
intranets, and help systems tor designers and authors who need to 
create effective electronic information. Includes CD-ROM with software 
containing files to help you utilize the models described in the book. 


Standards For Online 
Communication 

by JoAnn T. Hackos and 
Dawn M. Stevens 


(BSFOC) Our Price $40.45 



Linux Configuration 
& Installation, 

2nd Edition 

by Patrick Volkering, Kevin 
Reichard, and Eric F. Johnson 

Linux, the leading UNIX 
variant, has garnered 
loads of attention within i © J 
the UNIX community. The 
amazing thing about 

Linux is that you don't need a workstation to run it. Linux 
Configuration & Installation, Second Edition lets you run Linux today. 
Program with Linux using C, C++, Perl, and Tcl/Tk. The 2 CD-ROM 
pack offers one of the most popular Linux distributions, Slackware 96. 
and comes directly from Patrick Volkering. the creator of Slackware. 
(BLCI2) Our Price $35.95 





Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Web Publisher’s Design 
Guide for Macintosh} 
2nd Edition 

by Mary Jo Fahey 

This is the onfy book that takes you 
step-by-step through real projects 
designed by talented new media 
artists, internet design experts share 
their design secrets and art fiies (look 
for art fiies on the companion CD-ROM 
by artist's last name}. This expanded new edition includes 
Photoshop, Illustrator and DeBabelizer tricks from the first edition 
plus countless new ways to liven up your Web pages with 3D 
graphics, sound, movies, and much more. 


(BWPDG2) Our Price $35.99 


Includes 

Disk! 


II 1 


BASIC for the Newton 

by John Schettino and Liz O'Hara 

Program on Macintosh, Windows-based PC, or on 
the Newton itself. Straight-forward “programming by 
example" approach - you'll be writing Newton programs right away, 
includes 3.5" disk containing Demonstration NS BASIC and over fifty 
example programs (Newton not included). 

(BNEWT) Our Price $32.35 

SEE RELATED CATEGORY: Dev. Environments 



HTML For The World 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language the quick and easy way! This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You'll 
be up and running in no time. If you 
need to learn HTML fast - this is book 
is for you. 

(BHTMLW2) Our Price $16.15 
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Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 

The complete resource for creating 
Shockwave movies on the Web. This 
hands-on reference makes it easy to 
create Shockwave movies and put 
them on the Web. Expert tips from the 
creators of Macromedia's first 
Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started, Includes CD-ROM. 
(BMSFD) Our Price $27 


Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion. Just a few of the topics 
you’ll learn include: using search 
engines with URL’s; finding related internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key Internet contacts. With this book, 
you’ll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web sitel 
(BGHITS) Our Price $17.95 



Programmer’s Toolbox 
Assistant CD-ROM 

Instant electronic access to 
Inside Macintosh essentials, 
by Addison-Wesley Publishing 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment, Essential 
information for Macintosh software developers. Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool for Macintosh programmers. 

(STBASST) Our Price $89.95 




Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembly Language 

by Gary Kacmarcik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques. Learn to produce 
faster more robust software! 

(BOPTPPQ Our Price $35.96 



JavaScript For The 
World Wide Web 

by Ted Gesing and 
Jeremy Schneider 

This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. No long winding passages, concise, straightforward 
commentary explains what you need to know, 

(BJWWW) Our Price $16.15 
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Programming for the 
Newton Using 
Macintosh:Software 
Development with 
NewtonScript- Second 
Edition 

by Julie McKeehan & Neil Rhodes 

Praise for the Second Edition! "Rewritten from cover to cover, this 
new edition teaches you the essentials of programming for Newton 
2.0. You must read this book. Then read it again. And again .. 
SCRIBBLES (OxNUG, Australian Newton Users Group) Includes one 
CD-ROM for Macintosh 68030 or higher. 466 pp. 

(BPFNUM) Our Price $31.45 






Second Edition 

by Dave Mark 

New revised edition! Easy-to- 
understand - everything you 
need to start programming. Updated and 
enhanced exercises that lead you step by step. 
You'll leam function, variables, point datatypes, data structures, file 
input and output and more! Includes CD-ROM with Metrowerks 
CodeWarrior™ Lite. 


Learn C on The Macintosh 


(BLEARNC2) Our Price $33.25 

SEE RELATED CATEGORY: Dev. Environments 
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OBJECTIVE-C 
Object-Oriented 
Programming Techniques 






by Lewis J. Pinson and Richard S. Wiener 

Presents the basic concepts of object-oriented 
design and programming, and provides a 
precise description of the Objective-C 
language. Several small-to-medium sized applications using 
Objective-C illustrate the general principles of object-oriented 
programming. Covers the two main versions of the Objective-C 
language. Demonstrates the versatility and power of the NeXT 
machine as a platform to support object-oriented programming. 
Shows how to design, implement, and use hierarchies of classes. 
Explains the purpose of pre-defined classes and shows how they 
can be used in designing programs. 

(BOBJCOOPT) Our Price $34.15 


Inside CodeWarrior Professional 

by Metrowerks 

Includes CodeWarrior IDE User's Guide. This is the printed version of the 
documentation provided on the CD. Covers CodeWarrior Professional 
Release, the debugger and associated toots. 

(BiNSCWP) Our Price $34.95 

SEE RELATED CATEGORY: Dev. Environment 


Web site: http://www.devdepot.com 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 
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Metrowerks CodeWarrior 
Programming 

by Dan Parks Sydow 



includes CodeWarrior Lite, and Full Coverage of PowerP!ant™.The 
best information on Metrowerks CodeWarrior, giving full coverage to 
the Gold Edition. CD includes Code Warrior Lite. 

(BCWPROG) Our Price $35.95 


C++ Programming 
with CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Leam 
object-oriented programming techniques 
using C++ as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior. 

(BCPPCW) Our Price $32.35 



CodeWarrior Software 
Developmentusing PowerPlant 

by Jan L. Harrington 



C++ programmers will leam to develop object-oriented software 
applications for the Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source code for all the programming 
examples in the book and Metrowerks CodeWarrior Lite. 
(BCWSWDEV) Our Price $31.45 


Inside PowerPlant 

by Metrowerks 

Create PowerPlant applications using the CodeWarrior IDE and 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View. TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
(BINSPP) Our Price $34.95 
SEE RELATED CATEGORY: Dev. Environment 



AppleScript Finder Guide, English Dialect 

by Apple Computer, Inc. 

Provides definitions for Finder object classes and commands. Write, 
record, or run scripts that trigger toe same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 


E-mail: orders@devdepot.com 
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AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference for anyone using AppleScript to modify existing scripts or to 
write new ones. Contains useful information for programmers who are working on 
scriptable applications or complex scripts. Features detailed definitions of 
AppleScript terminology and syntax in the following categories: Value classes, 
commands, objects and references to objects, expressions, control statements, 
handlers, and script objects. Includes many sample scripts, discusses advanced 
topics such as writing command handlers for script applications, the scope of script 
variables and properties declared at different levels in a script, and inheritance and 
delegation among script objects. 

(BALGJ Our Price $26.95 
SEE RELATED CATEGORY: Scripting 


AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O'Hara 



Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that makes AppleScript applications truly 
"Mac Like”. Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design lips and practical approaches for 
implementation. Contains one CO-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2.1. source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price $31.45 




Special Edition 
Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 

This complete reference provides 
professional Web developers and advanced 
persona! users with the latest information 

on using CGI (Common Gateway Interlace) to interact with databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the HTML and CGI sample code from 
the book 

• Includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44.99 



y‘"IN 



r return x 


Java in a Nutshell, 2nd 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1.1, both on a package-by-package 
basis and in terms of overall functionality. A 
comprehensive tutorial on “inner classes" 
that explains how to use all of the new types 
of inner classes: static member classes, member classes, local 
classes, and anonymous classes. Practical, real world example 
programs that demonstrate the new features in Java 1.1, including 
object serialization, the new AWT event handling model, 
internationalization, and a sample Java Bean. 

(BJNUT2) Our Price $17.95 


JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 

Allows non-programmers to take advantage 
of the power of Netscape Navigator. Expand 
the capabilities of your Web page, without 
having to understand C or C++. CD-ROM 
contains “Wizlets’ that allows you to easily 
create your own JavaScripts. Takes you step- 
by-step through programming cross-platform JavaScripts. Details 
how to create JavaScripts for JavaScript aware Web browsers. 
(8JAVASCRPTJ) Our Price $40.50 
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3D Graphics 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS for Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API, 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages, 

(B3DGRAP) Our Price $35.96 


fticks of The 
Mac Game 
Programming Gurus 

by McCornack, Ragnemalm, Celestin, et al. 

For beginning to expert game programmers. 
Complete overview of all the necessary 
components of game programming on the 
Macintosh, Packed with valuable tools, 
utilities, sample code, CodeWarrior™ Lite and game demos, 
QuickDraw 3D and Power Mac optimization and inside info on how 
Glypha III was created, Hundreds of tried-and-true tricks, tips, and 
insider secrets tram well-known Mac game programming experts, 
(BTR1CKS) Our Price $45 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L. Perkins 
with Timothy Webster 

Add interactivity and multimedia to Web pages! 
A step-by-step guide to make your Website 
come alive. Learn the basics of programming 
Java applets and the concepts behind the Java language. Includes CD- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 


Java 


Black Art of Macintosh 


Game Programming 

by Kevin Tieskoetter 


Develop your own 3D games in 
C on the Mac. Includes CD with 
project files for both Symantec 
C and Code Warrior. Create 
freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code - all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35.99 


The Internet 
Marketing Plan 

by Kim M. Bayne 

This book gives you a comprehensive 
framework for producing and executing 
a customized Internet marketing plan. 
Marketing communications veteran Kim 
Bayne supplies you with a clear set of 
step-by-step procedures for 
establishing, implementing, evaluating, 
and managing your company’s online 
presence, 

(BTIMP) Our Price $35.99 


Order Toll-free 
800-MACDEV-l 

|8ti0622'3381] 


Advanced Color Imaging 
on the Mac OS 

by Apple Computer, Inc. 

Enhance your software’s color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX. Use the Pallette Manager to get the 
best colors on limited displays, Match 
colors between screens and input/output devices (scanners & 
printers), CD includes a complete reference information in both 
QuickView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 

(BADVCI) Our Price $33.25 


Protect Your Privacy on 
the Internet 

by Bryan Pfaffenberger 

This book/CD-ROM package gives you 
proven privacy defense strategies and 
techniques to help you make the Net a 
safer place to work and play. You’ll get 
the names of Internet privacy 
organizations that are working to 
protect your privacy rights and find out 
what you can do to help. 

(BPYP) Our Price $26.99 


























Inside Macintosh: CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes in electronic form. 
Includes: QuickDraw™ GX Library, Macintosh 
Human Interface Guidelines, PowerPC System 
Software, Macintosh Toolbox Essentials and More 
Macintosh Toolbox, QuickTime and QuickTime 
Components. Access over 16,000 pages of 
information with Hypertext iinking and extensive 
cross referencing. 

(BIMCD) Our Price $89 


VVAlT--’. 

There * 

Limited time offer to buy these Inside Macintosh products - 10 % off! For full 
More! product descriptions please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Inside Macintosh: Devices 

BIMDEV 

26.95 

Inside Macintosh: Files 

BIMFIL 

26.95 

Inside Macintosh: Interapplication Communications 

BIMIAPP 

33.25 

Inside Macintosh: Memory 

BIMMEM 

22.45 

Inside Macintosh: More Macintosh Toolbox 

BiMMAC 

31.45 

Inside Macintosh: Networking 

BIMNET 

26.95 

Inside Macintosh: Overview 

BIMOVER 

22.45 

Inside Macintosh: PowerPC Numerics 

BIMPPCNUM 

26.05 

Inside Macintosh: PowerPC System Software 

BIMPPCSYS 

22.45 

Inside Macintosh: Processes 

BiMPROC 

20.65 

Inside Macintosh: QuickDraw GX Prog. Overview 

BIMGXOV 

22.45 

inside Macintosh: QuickDraw GX Typography 

BIMGXTYP 

26.95 

Inside Macintosh: QuickTime 

BIMQT 

26.95 

Inside Macintosh: QuickTime Components 

BIMQTCOM 

31.45 

Inside Macintosh: Sound 

BIMSOUND 

26.95 

Inside Macintosh: X-Reference 

BIMXREF 

17.95 


(Book sale prices are contingent upon availability) 
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For Macintosh 
Programmers & Developers 

fvWfec h 

MAGAZINE 

MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with everything they neec 
know about software development. Topics like Rhapsody, Java, QuickTime, OPENSTEI 
Objective-C, C/C++, Object Oriented Technologies, product reviews and much more! 

Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 
(MTYRCM) Canadian tor 12 issues $59 
(MTYRFM) international for 12 issues $97 
Back Issues: each plus shipping (subject to availability} $10 

MacTech® CD-ROM Volumes 1-12 

• Includes Apple’s issues 1-29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, improved indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code—use them in your applications, with no royalties! 

• Full version of THINK Reference™—the original online guide to Inside Macintosh, Vols. I-VI 

• 80MB of FrameWorks/SFA archives and the most complete set of Frameworks archives known 

• Sprocket™! MacTech's tiny framework that compiles quickly and supports System 7,5 features 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, lips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes 1-12 Our Price $129 
(SMTCD12U) Upgrade from any previous version Our Price $49 





PRODUCT 


Here are more products. For full product descriptions please see our 
Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 

CODE PRICE PRODUCT CODE 


Development Environments 

AppleScript AppliicaBor^: Building Applcalicm w/FacaSpan .BAPSCAF $31.45 

Basic for the Huwttm Programming using NS BASIC....BNEWT... 3235 

C4. Primming..........BmWGAH ..31.46 

C++ Programming wttti ttxfeWantor.—~..BCPfCW,, .... .3235 

C/C++ SEJK User's Guide........BCPPtJSFR-...29.00 


Marinlosti C Programming Primer UokimH -—^_..BCPHIM1 

Mecirlosb C Programming Primer Vr*jme QL.... . .----BCPRIM? 

Madnlosti Pascal Pto/jj tuning Primer Uuhm I.—....I3PA5CPFB - 

Mastering ita Tbink Class Lirary....-___..._..BMASItKTCL 

Mastering the Toofbox Using INHK C .*.BCPR 1 M? 


OtykiWiiriKw Ifcsklte PrwveiPliTuil 

.... ....BINSFT... 

34.95 

Metrowems CodeWafdor Programming. .. 

(MMlPADG . 

CodeWarrtor Software Development using Power!’Ian! 

.BCWSWUEV. . 

31.45 

Otyocfiw-C ntjffMl-Ofinnlfirt Programming. 

.BOeJOOOFT. 

Cyberdog Programmers fttf 

. .. , BCYRtfftOG ... 

34.95 

Preserittng Magic Cap.....„ 

. BPRESMA9C. 

rfcisi Stuilcs lln* ftnwd <if Prngmpli TPK. 

.RDANPflQ... 

1935 

Real World Apple Guide. 

.RFrAIWIQ. 

kiside CodeWanioc Book 

BINSCW 

34.95 

Symantec C++ Proyinnjniirtfj. 

.BSVMCTP. 

instanl COFHSA 

...KG 

„ , ,17.99 

TaSgetit’s Guide to Destining Programs. 

.UTAUGEWT. 

Last Resort Programmers Fdilwn 

....JJLSTBSRT..„^ 

..74.95 

rn& i 1 cwer of i^ocprapn . 

. . .BOA NPM - . 

I earn C nn ihe Mariiiotift 2nd Edition. 

...BLLAfflCZ. 

. 33,25 

Vcjps Programming wittr Progti i(iti CPX. 

.....RVKPBO. 

Learn C++ on ihe Machteti 

.BURNCPP.._ 

.35.05 

WmbIsss For The Nuwton. 

„ ...BWIHttfSS .. 


PRICE 


.24.25 

24.25 

2425 

■26,95 

24.25 
,35.95 

34.15 

15.25 
35.95 
39.50 
17.S5 
19-95 
.30,60 
31,45 
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Hardware 


CD-ROM Handbook ... . . . ... 



.BCDHANO. 

14.36 

Uesipimg Cards & Uhvers lor the Macintosh „ . .. 



BCARD. 

26.% 

L-KGrWk1tar RoterfilCfi .. 



RLASERfifF 

n.m 




.DPOSYS^.. 

31.46 

PdweiTk: isv&tem A/tfutectLtfe . 



BPPCAHCH 

31,46 

Internet Related 

199-1 inrtfiffwt WTl 1 ^ 



894WHTE .. 

26.96 

Active Java . 



.BACtlAVA. 

23.36 

America Onhru lor Dummies. 



..BAODUM. 

. 17% 

CD By bangle . ..._. H . 



BCOBE . 

31.45 

Bidding & Maintammi) an kibHitit *tf the Macintosh . 



RRAMAJ 

45.00 




BCHPC.... . 

. ae.fls 

t^unputef privacy Handbook . 



..BPHIV . 

22.45 

E-Mail Essentials ...,. 



...BEMAIlE 

. 22.45 

Ftementa of E-Mail Style ..... 



BTMAll . 

__ 13.45 

Hwhfcd on Java . .... 



...BHJAVA,.. 

. 




...BIMSTANT .. 

.. 13.45 




...BTHENET. W1J< „ 

22.50 

InEerwt tar Dummies 2nd Edition .- , 



...BNETDUM2.. 

__ 17.99 

Interne! tor Dumnwea (Xildk Reference . 



...BDUMQCK . 

6,05 




...BNETDUM . 

17.95 

Interne! for Macs (or Dummies Bestseller Etfitinn. . ... 



...BIFMFDBE. 

3599 

internet Power Toots .. .. 



...BPWKTQQL . 

.. 36.09 

Internet Publcshinrj with Adotw Acrobat 



.. 0IPWAA 

36. DO 

Internet, The, Detox# Ftftian ... . 



...BNODELJJX .. 

. 31.59 

imranetwebDev tnienxtse AJiernaiiwos » Caenf^erver 



HJN1WD . 

BJAVAfSSEN 

. 44.99 

. .,17% 




aiAVAwin 

.. 1145 

Java Language API SuperQibte 



BJLAS .. 

5199 

Java Projjrarwiing with CGR8A ... 



6JPWC 

. -26.S9 

Liruf^mplt Irrf MgrinUsih 



ftJAVASCPPT 

4050 

Learn IfTML on the Mscmtosh ....... 



...BLHTM. . 

. MM 

1 parr. Java or in? MacmtoiTi 



tJUAVA. . 

. 31.45 

Mastering Netscape 2 0 for MadntesJt, Second Edition 

Mon; Internet (or Duitktim^ Storto Kft .. .* 



BMASNET2 . 

..BOUMflFT 

.. 36.00 

. 17% 

Mo^iic (nr Dummies .. ....... 



...BMOSDUM 

. 17.99 

Net Choi . .. 



BNETCHAT 

. 17,90 

tonlftbjCTit!? Pmdnfl Hanitnnk 



,, BNETORl .. 

45.00 




.. RMTTNTt . 

26.% 

Netscape Naviejalor Starter KJi tor Macintosh .... 



...Bf€TNSK . 

. 31.49 

Pert Quick Reference .. . . . .. 



...BPEfLREF . 

„. 17.99 

Planning and Unrungiimg VA/rJinitfr^ 



. BPIAMWFB 

35% 

Pk-OtoCi Vbm Private on the Interne! .. .... 



...BPYP . 

26,99 

Providing internet Services via the MscOS . 



epHomr .. 

.31.46 

Publish it on tno Web ... . 



..BWEBPUB 

.. 31,46 

TOPjIP Vul t VtiJ ? Bundle . 



. RTCPUflMTH 

.99.00 

Teach Yburcetf Java In 21 itojs,.,, ....... 



...BJAVAMAC . 

36.00 

!he interne! Marketingp^, L ,, LILI1 . 



BIIMP 

35.99 

Onterground Grate to Tctecoimniing 



RUNOFR 

22.45 

Using Lotus (fates as an tolraoet. ... 



mu .. 

. .40.45 

Wet> Read Mac Guide ... 



BWtUHtAD 

22.45 

Web Page Scnpting TccttiHjues 



BWEBPST 

45.00 

Weti PiiiWrJinrj will's Mntn AuntiU and POT 



nwrwAA 

%.95 

Wat) Weaving... 



..BWWEAV .. 

. 22.45 

Wfihmaster WaeinlMli 



BWEEEMAS 

26.95 

Scripting and Solutions 

AppfaScnpl Apphcaftons Suildnij Apps with FaocGpan 



...RAPSCAP... 

... 31.45 

AppteRcripl Rcrjptirg Arfailioris Glide .-,,. r ,--... 



...DSCRADD . 

.17,05 

Applied Macintosh Scripting 



...tSAI^UbD . 

. 31.45 

Oompteia HyperCard 2,2 Herxtoook . . . 



....BHYPCRD2 . 

31.50 

Complete 1 typer Tutk 7 .7' . 



nnypcfiD2 . 

.... 31,50 

Danny Goodman's Apple Guide starter Kit . . , 



....GUGAGtiK . 

. 31.46 

HyperCard Stack Design ... 



.UHVPSrA 

1995 

JavaScnpC tor Macintosh . 



RJAVASCRPT 

40.50 

Peil Ouirt; Itefererice •■■rrr..rnnr-i 1 --m-..r—.r.. 



... BfmnEt . 

. 17.99 

Real World Acute Guide .... _ 



BHtALWLU... 

35.95 

Technical Reference 

Active Java 



BAC1JAVA 

23.36 

Apple CD ROM 1 tmdtauk 



BcniiAWi _ 

14.36 

An of Human fateriace Design .. 



...BAUD .. 

_ MM 

Bisc*. Art of Mac Game iTogrammnQ. 



88LACK ... 

35,99 

C++ TOC PlitfT¥Tlgj; .. . ....„„„ 



BCPPDLIM ^ 

22,46 

C to Dummies Vo! f 



ncniM . 

__ .17 95 

ttovetoplng ObfaCt Oriented Software lor the Macintosh . 



BUt YUS . 

2606 

Extaxfag to: Mac Tooaxw ..... 



BFTMT.. ( ,„ . 

.22.46 

Hjlh u1hJ*i *t; of MimvihEifi Prurjrrinnuimj . 



rrauND .. 

35.96 

Fragment of Your Imagination . 



..JRWG,.™,, 

.35% 

Guide to Macintosh Software Localisation . 



BL0CAU2 

24.26 

Guido tu Maonfaptt System 7 S,.._ ... 



RSYS75 . 

. 22.50 


hisidu AppleTalk 

....BAPTALK. 

31 45 

insitte iIib Uadrtbofih Tgn(hn« : 1 , 11 ,. 3 ,,,. l ,,,,,,., [ 

............... Rr^iWM 

22.45 


. blaserref. 

17.% 

I Ram C++ cm thu Macintosh .... 

. RIRNCPP. 

35.05 

1 eiSTi Cun Kit; M-Tfrirf-Ji igj Frjilkn...... 

..BLEARNC1. 

J1 15 

Lnam C on the Mac^itosh 2nd fcdKion 

BLEAHNC2 . 

:n.Jh 

Mac PfctTamming tor Dummies. 

eMAcmjM__ 

17 95 

muifttufJi C Prognunmcr Primer Votwre 1 

BCPRiMT . 

21 25 

Macintosh r. (Yr^jrarmrtft- Prinar ttokima 7 . 

...BCPBM2. 

24 25 

MadfitoS) 0lfc2 Prag. Reference lAtoWri write Objects 

Maontesh Pascal Programmirig Primer Yntotre 1... . 

_ RfflF? ... 

40 45 

. MPASCPn . 

24.25 

MacisijQsfiFtogpammlfig Secf-els 2mJ Kfitkii,. , L . [L 

.... .. 

?$. 7fi 

MfiDwrlOSft PrOQTSI i^i^iiriQ T0£ftndQfu6S 

.... ...BPTCCH. 

3’ 95 

Mictesuli V^uai J++ 11 $mrcrtK»fc.. 

.BMVJS.. 

3595 

More Mac Programming Teptmigues ,, ,,,, ,,_,,. im . r 

.BMOREltCH. 

34.50 

Network Frocitiers tkindte 

BNETTB. 

5995 

Nswtoi Progmmming GuWe„.. 

Object DrierUed Prograinming Design.. 

...QNFWTPGU® 

.,..,„.„BQOPROOES.-. 

40.46 

20.66 

Opllmlilng PrawsrPC Cfirtfi .,. 

. . .boptppc.. 

35,96 

Pert Quick Reference . 

.BPERIBEF. 

17 99 

PhslSrriprl 1 angiuigBi RBfnrfflr»ra | i. 

..BPSLANflEF .. 

29.66 

I^werbook- Digital Nomad's Guide 

... BPBTDNQ.. 

22.46 

PowerPC Programmers Tooikit 

.SPPCPT . 

40.50 

Progranwmng Inhnduchon to the Mactntesh Family 

.[FAMILY. 

22.45 

Programming (or Syaam 7 .... . 

.BSVS7. 

24 25 

Programming Ptfaier Mtoiniosn Volume 1 

. . BPRIMMAC . 

34.15 

Progrymmino Sterter Kit .... .... 

. ......BPRQSTAFTT. 

■SO ;J] 

PhKJfEHTlIItjng Witt) AppiflTafr ■jjji...ll[i::i-lljhiiiiih 1111111.1111 

. .. ....^......BPflQST.. 

2245 

QuickTime - Ottkaf Glide to Macmtosh Ushs-._. 

. . .BQTGUOE... 

45 00 

Real World Apple Gutte, ,. ..* .. 

. ... 

35 95 

ftesfite AM Nighi Diner _ __ „„ rr ___ 

.QRESOWE.-. 

22.45 

ftesfttt Complete 2nd ErSton. .. 

mma . 

31.45 

Rest* Reference.. .. . 

BRESHTREF__ 

2G.95 

Software hy Oesigtr: Creolmg User Fricndy Software 

BDCSJGN. 

26.95 

Symantec C++ to ted Macintosh: The Rasies... 

„. . RaytMTB-. 

31.46 

loach YOurseit Macintosh C++ fa 21 Days.. 

.. _ ........BCPP21D.—.. 

?r>.! W 

Tectvwcat inoodychon in Uie Macintosh Family. 

BTTTTMF .... . 

24.26 

Tog on Software Design. 

..BTOG 

26.95 

Wn eiess to the Newton Development tor Mobil Comm 

RWfflELESS 

31.45 

iWnltrm I nralirahta ^l+vjarf* 

RIDCA1 . 

24.25 

Miscellaneous 

3D Grftrfttcs-1 Ips Tricks, i Tocbnkiuds. 

.B3DGTTT. 

31.4G 

A FrEHjmaftt of Yottf tmagtoatlon 

. DRAG.... 

3596 

Arlnhf! Premiere to lie kferarrtnsh ... . 

.- rTr — n • .RPRFM.. .. 

44.95 

America Online tor dummies 

BAOLDUM. 

17.% 

AppipGiftte Camptete 

.BAPLGO . 

35.96 

Art of f kircin fatertscu Desijri.. 

.mm . 

29.65 

CD-ROM Guide to MuUimedfa Antooring „ .. 

.^BCOMULU.. 

40.45 

CompuServe ter Dummies 

____ ,BCSOUM.._._ 

17 95 

Dealing Internctnp CC ROM... 

RWTTWHR ... 

35 95 

Cyba punk ttandhoak. 

.BCYBPUNK. 

S.95 

Uamy Goodman's Appte (Aide Stoier Krl. _ 

.0OGA6SK. 

31.46 

Oamy Goodman's Mactrlosh Handbook 

BGoomn 

26.95 

TmaiviWivk?; Sutrcte Dxk; tick ., f ...... 

. JMTFWSC,™ .. 

9.95 

rraineWorks Magasne Back Issue 

. ^.MINVBWCK. 

«,0U 

Global Interlace Design 

BGLOSAL — — 

32.35 

Gramme Gems 7 

TOFMS2. 

44% 

Graphic Gems 4.... ..... 

.BGtMS4 

44.95 

Daptve GemsV 

.... BGBHS5. 

44 95 

Indini D RmrrMlurt . 

... iwmcrv. 

40 50 

IrcJite DarflcELw 5 with 1 Ifhjo to MnciiiEosti 

.BG5WUM. 

41.99 

Ulfi NlgiM wlto MacHach __.. 

. .SLATE.. 

26 95 

Mac Bathroom Reodut 

. IBAT1I . 

. 11.70 

MucruiiiEidin DiiueJcji 1 iriyu Wnrkstioff, Pi hE IdiluMi 

. DMD4.W2. 

40.50 

Mac Gcroamer: The Ullimste Mecmlosh SuDcrcherging Kit. 
Macintosh Dash Course 

. BSCHtAM 

. BCRASH.... 

. 31.50 

26 95 

MacTud) Back fesocs ... 

. M7HACKKS ... 

.. .10.00 

MacwtfkJ LJltimato Macintosh Prograrrimtog Book . 

... mjUMAC.._ _ 

35.95 

Managing AppleShare £ Workgroup Servers 

BMAWS...,, ... 

26.95 

MADACON 93 CD TOM 

.sMAimi..- . 

. 9.95 

MuHirnetfeMtmrtng: tkAfng and Developing Dopimeute.... 
MuttimKfe Starter Kit to Maemtosh . . 

. BMMALfTH . 

... BMMSTART.. . 

31.45 

27,00 

Network Frontiers Bundle 

.. BNFTFR . 

5995 

FYohi Irom f Jtpcriencn 

. BPflnnT .. 

22.45 

Rest jit Complete Second Edrttan 

„ .. (JHtStD2— . 

31.45 

Sal Macs. Bombs and Disasters __ _ __ 

. . BSAflMAC . 

22,45 

^ljpri MacTriJ® I,, , I,, J1 ,ii„ tL .,r-,-,iii.. 

. (KTUPIDMAC . 

17.95 

Ow ftemonts nt f-Marl F*tyte . 

. .REMAN. 

13.45 

1 be Software Dev^oper s 5 Marketer's Legal Companion 

. .. „ .PS0AM1C tt,. 

33.26 

Tog on Software Design ..... . 

.., BTOG . 

2696 

TriiJts nt Jlte Mix: Gamfi fiuiR . . ... 

. .STOCKS. .. 

_ .45.00 

Zen and the An ot Resource Editing., ... . 

... 82AA0HE_ 

27 00 
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All entries in this index are alphabetized. For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 


1000 Games for Macintosh__ 17 

3D Qaphics Prv&amming Usfeg QuickDraw 3D...............27 

A.D. Software_..______.__12 

Absoft Gorporaikn----„*«.--...-*...,-.„„..,..„4 

Abuse....______,_______—__ 17 

Additional Development Environments Listings 

Additional Listings for Games .—...„«...~™.17 

Additional Listings for Tools, Libraries & Utilities 

Adianta Inc,,.... 

Advanced Color Imaging on the Mac OS....... 27 

AG Group, Inc, _.......—...............10 

Altum Software. Inc.....,.... . ..„„.,...5 

Apple Computer, lnc.,,.„,.*».........3,14,15,16, 26. 28 

Apple Dyian Technology Release..............3 

Apple Guide Integration....... ..18 

Apple Media Tool Programming Environment 2.1 ——..—-—™,.™15 

A&jfcScrpt Appkxtiong Abiding Apps w/FaceSpan & AppleScript ---- 26 

AppleScript Finder Guide* Engtish Ootecf,.,..„.™..... ,25 

AppleScript Language Guide, .— -™„...-—-™ JS 

AppleScript Software Development Toolkit 1.1___14 

AppSketcher 1.0 for BeOS „_......._„___—-„™,7 

Audio Track.,.,.,,..™,,.—...—„—,-- ———.-...-- 16 



B-Thee HELPER Z2__________ A 

Bare Bones Software...*......,....,8,9.12 

BASIC for the Newton ......... 24 

BBEdit 4.0.4..........„...9 f 12 

BeachWare, fine...........It, 16,17 

BeaiW&m, Inc. ........-...—.......7 

Bee-one........— ---11 

Bhck Art of Macintosh Game Programming .....27 

Bowers Development----— .——,,——.—.8 

Bungia Software.......... 


C+i Ftogamming with GodtiMamor..^ ______ 25 

c-tree Plus® Database Handler.*™,,.,,——..--——..-.-6 


Capiano Computing,,™__™ ___...... 10 


Captivate 4.6c Essential Graphics Utiifies ........,.m..i.....16 

Casino!......17 

Ceteslin Gonjwiy.._™„.—„—........7 

Clip VR™__ _ ____________15 

CodeBuilder,_„___„___-__5,9 

CodeWarrior Discover Programming Edition............ A 

CodeWarrior for BeOS 3...._____..__ 

CodeWarrior for PalmPilot________..2 

CodeWarrior Latitude.________—. 2 

CodeWarrior Professional Release... . . ....■■■■.,■■■■. 2 

CodeWarrior Software Development Using RowerPtant .,,..—----- 25 

CodeWarrior Wear.... .........■■■■■ - l J)ttr .™19 

Compile It!...........10 

Conix Graphics —...—...— ......10 

CPU Doubler......™10 



D'OLE Dev Guefe ______ 20 

Debugging Macintosh Software with MacsBug „____ 

Designing 3D Graphics., ....„..„...... 22 

DesignWorks 4.0_______10 

Developing CGI Applications with fiarf................„..22 

Digital Technology International__...... __......... 14 

Digltool, ino., ......... __ .4 


Dtscpwenhg OP&JSTm Mac . 

Discovering DPENSTEP, Whdbws 

dtF.™___ 

dtF Amends....— 


.... -20 

_ _ ____ 20 

... A 

_____ ......8 


—E— 


EOF Owatoper s Guide for EOF lx. ....... AO 

EOF Developer s Guide for EOF 2.0 .............. 20 

EOF Developer's Guide for EOF2,1(Mac & Windows) ...... 20 

qVok Productions...................16 

Excel Software................ .7 


=F= 

FaceBpan v2.1............. 



14 

Faircom 



...6 


Future Basic II-------....----— 



GeffiTg Hfts-7he Definitive Guide To Promoting Vfcxir Wtarfe......... 24 

Getting Started Wtth WebObjects ...............20 


HTML For The World Wide Web p 2nd fiiftbn........24 

HTML Sourcebook, 3rd Ertitbn .........2f 


Increasing Hits and Sefihg More on your I4feb Site ........ 21 

Inside GoddWamor Professional ............25 

Inside Macintosh: CD-ROM....... 

Inside Macintosh: Devices ......... 28 

Inside Macintosh: Fifes .......... ..28 

Inside Macintosh: imaging with QuickDraw ............................28 

Inside Macintosh: tntQrappteation Gommuntatioits.. ........ 28 

Inside Macintosh: Memory ............ 

ksidk More Macintosh 

Inside Macintosh: Networking -----------,.,.,,...,.,.28 

Inside Macintosh: Operating System Unities _______ 28 

Inside Macintosh: Overview ... ....... >■ . .....28 

Inside Macintosh: PowerPC Numerics ...........23 

Inside Mboiniosh; PowerPC System Software_........... 28 

inside Macintosh: Procossa$.„. ..........28 

inside Macintosh: QuickDraw GX Environ. 5 Lftfiftes ...——^..„.,J38 

/nsde Madnfnsh, QAADrew GX Graiphitis... -------—28 

Inside Maonfosh: QukMXzw GX QbfOctS,,^ _______—.-.,.39 

Inside Macintosh: QuickDraw GX Printing ........2S 

Inside Macintosh: QuickDraw GX Printing Extmsium --------........28 

/hs^Macihfiish: QucADraw GX Prog. Qrerwew.......... 28 

Inside Macintosh: CkfckDrw GX Typography.. ..........29 


Inskit} Mftdftlnsh: C}ukkTime Comffflnuntti . 

..„.,^8 

Inside Macintosh: Sound ... 

.,, 28 

Inside Macintosh: 7ejrf...... 


Inside Macintosh: XJkfamce __—..... 

j^siefc . .... 

.. 

......25 


Java in a M/fsheff, _____ 

.. . .. 26 

JavaSOrpf L I D&veioper's Guide. ..... . . 

23 

JavaScript Cookbook... ......... 

. 21 

JavaScnjpf far (he Macintosh ....... 

. ..... 26 

.i&vaScnpt For The World Wide IVeh.... 

. 24 

■JavaScrfaf & Netscaoc Wizardry ... 

. 23 


_=k=_ 


Ukewood Software^......—-----11 

Late Night Software Ltd.., .. . ——.....„14 

Loam Con The Macintosh Second Edition ........... ...25 
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Unux Configuration & Installation, 2nd Edition., ....... 23 


Roaster... 


..5.13 



MacA&D 6.0-.....-...... 

_7 

Macintosh Common Lisp 4.0..... 

..4 

Macromedia Shockwave for Director. ........ 

.... ...24 

Mac Tech® CD ROM It/ M2. .. 

. ....29 

MacToch® Maganne ____ _ 

.. 18, 29 

MacTech® Mouse Pari.-........... 

....19 

Magreeable Software....______ 

..e 

Main Event Software........... 

Mainstay ........ 

...14 

„-.4 p 9.12.16 

Mango Tree Software............. 

.. . .—14 


Roaster Technologies, he... 
Royal Software, he... 

RUmpllS..::... 


...5.13 

..6, 10,13.14 

_._._13 


Script Debugger.. 
ScriptDemon —, 

Scripter 2.0_ 

ScriptGen Pro.. 


_-14 

_6,13 

_14 

...8 


Mmfl mn .--- . ..........13 

Measuring the impact of Yfcur Wteb Site __............ *. 21 

Media Cleaner Pro__________ 

Memory Mine— ..._—...-----——.........6 

Metrowerks.........-.......3, 19 

MefroweritS GodeVVbrrior Programming .......25 

Mefrowedcs tfeuaf SourceSafe.....2 

MkLinux: Microkernel Linux for the Power Macintosh-.—.——4 

Multimedia Authoring with Apple Media Tool —------IS 

MulliWare Multimedia Collection___■■■■■, ,16 

Music Tracks ———___,....___■■,.,..18 


Seapire Software, ha -9 

Snrartcode Son ware ......................................6,1 2 

SoftPolish CD-ROM ____._...___„8 

Specif Edition Using CGI, 2nd Edition .. aMMHaMMI .....,—..,.....,.. 26 

Spellswell Plus 2.1___________6 

Spotlight ___-____7 

Standards For Or#?e ComntuniCQtion^*.* ...,.„„„23 

Staz Software,_____—....8 

Step-Up Installer Pack_ m ..,.,i m o.,. n r T n,m -** 

StepUp Software.—....—.—.*.8 

StoneTable 68K/PPC ---- - --------J 

SlooeTabtel Piialishing.,............... —7 

System 7.5 Technologies- -_ .18 


Newton Toolkit 1.6 (MacTWin)___....3 

NeXT Software Inc, —..... ...20 

Nfcus Software ..— —...■11 

NS BASIC 3.6 for the Newton with Visual Designer..„..„.... .5 

NS BASIC Corporation....._,,—6 


TCP/IP Scripting Addition————--, , ■ 14 

Teach Yourself Jawa fat Macintosh in 21 Days ...... 27 

Tenon Intersystems ............ w ,......5,9,12,13 

Terran Interactive. . .........-...... ..16 

TestTrack-Bug Tracking the Macintosh Way --~-9 

The fetemaf Strategic Plan .....—„.. 2t 

The Marathon Trilogy Box Set..,..... i _.17 

The Way Computer Graphics Works .....-______2? 


Objecd'Ormited Proyrijfmiing and Ot^ac&ve C....... 

QBiiFGWF-'C Object-Oriented Programming Techniques 

. 20 

.25 

The web Navigator ..... 

...... 21 

.....9 

■ft ObjectMasler Professional Edition ....... 


Tricks of The Mac Game Programming ..... 

...... 27 

ObjeclSet Mail SDK......... 

.6,12 


...17 

Onyx Tt^dindogy, Inc. . .... 




OOFILE Reporter Writer 

. 

__12 

■1 — U— 


OpenGL for the Macintosh..... 


UNI SOFTWARF PLUS.... 

.,-J 


Optimihng PowerPC Code : Prog, the PowerPC in Assembly language. .. 24 

Orchard Software _---------—10 


Uswig LOP 2.1 w/ OPENSTEP (Mac & Windows}.. 


....20 


PageCharmer 1 J)______ 

Phyla™: Object-Oriented Database.. 


.,12 

-9 


Podeum Sport...............19 


Power Box,_ 

Power MachTen- 


____.....___11 

_-_-_—..-_ —13 

Practical Object-Oriented Development m Ch- and Java ..—......22 

PreFab Software, he..«.............,..,...14 

Prime Time Freeware.........—......4 

Programmer's Toolbox Assistant CD-HOM ......*.... 24 

Rvgmmming for the Nrwtnn Using Macintosh ...—___ >2$ 

Programming for The Newton Using Macintosh , 2nd Edition.... ..... .22 

Putty Software, lnc.,.„,...—..—12 


VIP-BASIC: Visual Interactive Programming m BASIC 

VfP-C: Visual Interactive Programming in C—-* 

Virtual Reality Programming with QuickTime VR 2.0 
Virtual Tutor for QtwckHma VR---- 

Vivistar ---—— _-- 

VOODOO 1.8_____ 

VText... . ..... 
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QC«__ 

QUED/M 3.0_ 


QuickTime Developer's Kit —____ 

QuickTime VR 2.0 Authoring Tools State 


--- 11 
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r-tree Report Generator-... 

Rach Jrc..... 

Rhapsody OevdoperQS Guide.. 


——...19 

_____-. 22 


Waters Edge Software,............. 

WAVES.. ....... .... ■rrTi~,niiTirtT 

..-.9 

.. 

Wed Grapftios Toots and Techniques...,^ ...—— 

Wfih bfarketing CrvirftfYKiir .. .. , 

.. ..23 
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Web Publisher's Design Gid e for Macintosh, 2nd Edition .... 

NutUidt, Deluxe Edition ,,.,^— —... 
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—.—24 

. 
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WebSiphon............ 
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-=- PowerPC Native 
Multi-threaded 
- Compiled Language 
— Caching 


WebSiphon allows you to rapidly design custom 
server-side web applications by embedding 
an easy to learn, yet powerful scripting 
language directly into your HTML documents. 
WebSiphon also includes Verona, the only 
Macintosh flat-file database server written 
specifically for use on a web site. If you have 
ever felt restricted by other web site 
development products on the market, then 
this is the tool for vou. 


d em o s 


vygbSeridnel 


WebSentinel replaces or supplements your 
web server's built-in security, allowing more 
flexibility and power to manage users and 
secure areas with a complete Macintosh user 
interface. Features include GREP match 
strings, custom “No Access’" files for each 
realm, and full caching. WebSentinel’s plug¬ 
in architecture allows you to integrate with 
your existing user data and security 
architectures. 

www.purity.com 


$99 


1016 mopoc circle, suite 101 
aushntx 78746 
phone 512.328.2288 
fax 512.328.2688 
info@purily.com 


curdy ttv fct-Jis'nditit a yJ&iar’-, ■ 

*!l rijp&j&brvo; all nit™ ir*i-- 

sratfw -m » ml •tip'rb-i? Mi** * W (nr prt miu* tmhai *■ r . h> sit 































Wwhan Rhapsody gets hare, 
j- you’ll be ready...with 
"-'To ieWarrlor Latitude' 1 . 11 
'It* s Metrowarks* newest _ 
porting tool, designed to 
give you a lag up on 
Rhapsody. Recompile your 
Mao OS source code, link it 
with the Latitude libraries 
and rind out which portions 
of your soda are going to 
port smoothly...and which 
won't [forewarned ia fore¬ 
armed]. As Rhapsody evolves, 
so will Latitude; registered 
users will receive all 
developer releases, the 
first full release, plus 
, one additional update, 
lodeffarrior Latitude, $399. 
The tools you need, .-.and 
a' little attitude to boot. 
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